 |
|
| If you can't view the Datasheet, Please click here to try to view without PDF Reader . |
|
|
|
| If you can't view the Datasheet, Please click here to try to view without PDF Reader . |
|
|
| Datasheet File OCR Text: |
| To all our customers Regarding the change of names mentioned in the document, such as Hitachi Electric and Hitachi XX, to Renesas Technology Corp. The semiconductor operations of Mitsubishi Electric and Hitachi were transferred to Renesas Technology Corporation on April 1st 2003. These operations include microcomputer, logic, analog and discrete devices, and memory chips other than DRAMs (flash memory, SRAMs etc.) Accordingly, although Hitachi, Hitachi, Ltd., Hitachi Semiconductors, and other Hitachi brand names are mentioned in the document, these names have in fact all been changed to Renesas Technology Corp. Thank you for your understanding. Except for our corporate trademark, logo and corporate statement, no changes whatsoever have been made to the contents of the document, and these changes do not constitute any alteration to the contents of the document itself. Renesas Technology Home Page: http://www.renesas.com Renesas Technology Corp. Customer Support Dept. April 1, 2003 Cautions Keep safety first in your circuit designs! 1. Renesas Technology Corporation puts the maximum effort into making semiconductor products better and more reliable, but there is always the possibility that trouble may occur with them. Trouble with semiconductors may lead to personal injury, fire or property damage. Remember to give due consideration to safety when making your circuit designs, with appropriate measures such as (i) placement of substitutive, auxiliary circuits, (ii) use of nonflammable material or (iii) prevention against any malfunction or mishap. Notes regarding these materials 1. These materials are intended as a reference to assist our customers in the selection of the Renesas Technology Corporation product best suited to the customer's application; they do not convey any license under any intellectual property rights, or any other rights, belonging to Renesas Technology Corporation or a third party. 2. Renesas Technology Corporation assumes no responsibility for any damage, or infringement of any third-party's rights, originating in the use of any product data, diagrams, charts, programs, algorithms, or circuit application examples contained in these materials. 3. All information contained in these materials, including product data, diagrams, charts, programs and algorithms represents information on products at the time of publication of these materials, and are subject to change by Renesas Technology Corporation without notice due to product improvements or other reasons. It is therefore recommended that customers contact Renesas Technology Corporation or an authorized Renesas Technology Corporation product distributor for the latest product information before purchasing a product listed herein. The information described here may contain technical inaccuracies or typographical errors. Renesas Technology Corporation assumes no responsibility for any damage, liability, or other loss rising from these inaccuracies or errors. Please also pay attention to information published by Renesas Technology Corporation by various means, including the Renesas Technology Corporation Semiconductor home page (http://www.renesas.com). 4. When using any or all of the information contained in these materials, including product data, diagrams, charts, programs, and algorithms, please be sure to evaluate all information as a total system before making a final decision on the applicability of the information and products. Renesas Technology Corporation assumes no responsibility for any damage, liability or other loss resulting from the information contained herein. 5. Renesas Technology Corporation semiconductors are not designed or manufactured for use in a device or system that is used under circumstances in which human life is potentially at stake. Please contact Renesas Technology Corporation or an authorized Renesas Technology Corporation product distributor when considering the use of a product contained herein for any specific purposes, such as apparatus or systems for transportation, vehicular, medical, aerospace, nuclear, or undersea repeater use. 6. The prior written approval of Renesas Technology Corporation is necessary to reprint or reproduce in whole or in part these materials. 7. If these products or technologies are subject to the Japanese export control restrictions, they must be exported under a license from the Japanese government and cannot be imported into a country other than the approved destination. Any diversion or reexport contrary to the export control laws and regulations of Japan and/or the country of destination is prohibited. 8. Please contact Renesas Technology Corporation for further details on these materials or the products contained therein. SH7290 E10A Emulator User's Manual ADE-702-289 Rev. 1.0 12/26/01 Hitachi, Ltd. HS7290KCM01HE Cautions 1. Hitachi neither warrants nor grants licenses of any rights of Hitachi's or any third party's patent, copyright, trademark, or other intellectual property rights for information contained in this document. Hitachi bears no responsibility for problems that may arise with third party's rights, including intellectual property rights, in connection with use of the information contained in this document. 2. Products and product specifications may be subject to change without notice. Confirm that you have received the latest product standards or specifications before final design, purchase or use. 3. Hitachi makes every attempt to ensure that its products are of high quality and reliability. However, contact Hitachi's sales office before using the product in an application that demands especially high quality and reliability or where its failure or malfunction may directly threaten human life or cause risk of bodily injury, such as aerospace, aeronautics, nuclear power, combustion control, transportation, traffic, safety equipment or medical equipment for life support. 4. Design your application so that the product is used within the ranges guaranteed by Hitachi particularly for maximum rating, operating supply voltage range, heat radiation characteristics, installation conditions and other characteristics. Hitachi bears no responsibility for failure or damage when used beyond the guaranteed ranges. Even within the guaranteed ranges, consider normally foreseeable failure rates or failure modes in semiconductor devices and employ systemic measures such as fail-safes, so that the equipment incorporating Hitachi product does not cause bodily injury, fire or other consequential damage due to operation of the Hitachi product. 5. This product is not designed to be radiation resistant. 6. No one is permitted to reproduce or duplicate, in any form, the whole or part of this document without written approval from Hitachi. 7. Contact Hitachi's sales office for any questions regarding this document or Hitachi semiconductor products. IMPORTANT INFORMATION READ FIRST * READ this user's manual before using this emulator product. * KEEP the user's manual handy for future reference. Do not attempt to use the emulator product until you fully understand its mechanism. Emulator Product: Throughout this document, the term "emulator product" shall be defined as the following products produced only by Hitachi, Ltd. excluding all subsidiary products. * Emulator * User system interface cable The user system or a host computer is not included in this definition. Purpose of the Emulator Product: This emulator product is a software and hardware development tool for systems employing the Hitachi microcomputer. This emulator product must only be used for the above purpose. Limited Applications: This emulator product is not authorized for use in MEDICAL, atomic energy, aeronautical or space technology applications without consent of the appropriate officer of a Hitachi sales company. Such use includes, but is not limited to, use in life support systems. Buyers of this emulator product must notify the relevant Hitachi sales offices before planning to use the product in such applications. Improvement Policy: Hitachi, Ltd. (including its subsidiaries, hereafter collectively referred to as Hitachi) pursues a policy of continuing improvement in design, performance, and safety of the emulator product. Hitachi reserves the right to change, wholly or partially, the specifications, design, user's manual, and other documentation at any time without notice. Target User of the Emulator Product: This emulator product should only be used by those who have carefully read and thoroughly understood the information and restrictions contained in the user's manual. Do not attempt to use the emulator product until you fully understand its mechanism. It is highly recommended that first-time users be instructed by users that are well versed in the operation of the emulator product. I LIMITED WARRANTY Hitachi warrants its emulator products to be manufactured in accordance with published specifications and free from defects in material and/or workmanship. Hitachi, at its option, will replace any emulator products returned intact to the factory, transportation charges prepaid, which Hitachi, upon inspection, shall determine to be defective in material and/or workmanship. The foregoing shall constitute the sole remedy for any breach of Hitachi's warranty. See the Hitachi warranty booklet for details on the warranty period. This warranty extends only to you, the original Purchaser. It is not transferable to anyone who subsequently purchases the emulator product from you. Hitachi is not liable for any claim made by a third party or made by you for a third party. DISCLAIMER HITACHI MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, ORAL OR WRITTEN, EXCEPT AS PROVIDED HEREIN, INCLUDING WITHOUT LIMITATION THEREOF, WARRANTIES AS TO MARKETABILITY, MERCHANTABILITY, FITNESS FOR ANY PARTICULAR PURPOSE OR USE, OR AGAINST INFRINGEMENT OF ANY PATENT. IN NO EVENT SHALL HITACHI BE LIABLE FOR ANY DIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY NATURE, OR LOSSES OR EXPENSES RESULTING FROM ANY DEFECTIVE EMULATOR PRODUCT, THE USE OF ANY EMULATOR PRODUCT, OR ITS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. EXCEPT AS EXPRESSLY STATED OTHERWISE IN THIS WARRANTY, THIS EMULATOR PRODUCT IS SOLD "AS IS ", AND YOU MUST ASSUME ALL RISK FOR THE USE AND RESULTS OBTAINED FROM THE EMULATOR PRODUCT. II State Law: Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may have other rights which may vary from state to state. The Warranty is Void in the Following Cases: Hitachi shall have no liability or legal responsibility for any problems caused by misuse, abuse, misapplication, neglect, improper handling, installation, repair or modifications of the emulator product without Hitachi's prior written consent or any problems caused by the user system. All Rights Reserved: This user's manual and emulator product are copyrighted and all rights are reserved by Hitachi. No part of this user's manual, all or part, may be reproduced or duplicated in any form, in hardcopy or machine-readable form, by any means available without Hitachi's prior written consent. Other Important Things to Keep in Mind: 1. Circuitry and other examples described herein are meant merely to indicate the characteristics and performance of Hitachi's semiconductor products. Hitachi assumes no responsibility for any intellectual property claims or other problems that may result from applications based on the examples described herein. 2. No license is granted by implication or otherwise under any patents or other rights of any third party or Hitachi. Figures: Some figures in this user's manual may show items different from your actual system. Device names: Sections 1 to 5 in this user's manual use SHxxxx as an example of the device names. Limited Anticipation of Danger: Hitachi cannot anticipate every possible circumstance that might involve a potential hazard. The warnings in this user's manual and on the emulator product are therefore not all inclusive. Therefore, you must use the emulator product safely at your own risk. III SAFETY PAGE READ FIRST * READ this user's manual before using this emulator product. * KEEP the user's manual handy for future reference. Do not attempt to use the emulator product until you fully understand its mechanism. DEFINITION OF SIGNAL WORDS This is the safety alert symbol. It is used to alert you to potential personal injury hazards. Obey all safety messages that follow this symbol to avoid possible injury or death. DANGER DANGER indicates an imminently hazardous situation which, if not avoided, will result in death or serious injury. WARNING indicates a potentially hazardous situation which, if not avoided, could result in death or serious injury. CAUTION indicates a potentially hazardous situation which, if not avoided, may result in minor or moderate injury. CAUTION used without the safety alert symbol indicates a potentially hazardous situation which, if not avoided, may result in property damage. WARNING CAUTION CAUTION NOTE emphasizes essential information. IV WARNING Observe the precautions listed below. Failure to do so will result in a FIRE HAZARD and will damage the user system and the emulator product or will result in PERSONAL INJURY. The USER PROGRAM will be LOST. 1. Do not repair or remodel the emulator product by yourself for electric shock prevention and quality assurance. 2. Always switch OFF the host computer and user system before connecting or disconnecting any CABLES or PARTS. 3. Connect the connectors in the user system and in the user interface cable by confirming the correct direction. 4. If the PCI interface board for the E6000 or E8000 emulator (HS6000EIC01H) and the E10A emulator PCI card are mounted on the same host computer, the connectors may be illegally connected. V Warnings on Emulator Usage Be sure to read and understand the warnings below before using this emulator. Note that these are the main warnings, not the complete list. WARNING Always switch OFF the host computer and user system before connecting or disconnecting any CABLES or PARTS. Failure to do so will result in a FIRE HAZARD and will damage the user system and the emulator product or will result in PERSONAL INJURY. The USER PROGRAM will be LOST. CAUTION Place the host computer and user system so that no cable is bent or twisted. A bent or twisted cable will impose stress on the user interface leading to connection or contact failure. Make sure that the host computer and the user system are placed in a secure position so that they do not move during use nor impose stress on the user interface. VI Preface Thank you for purchasing the E10A emulator. CAUTION READ section 2, Preparation before Use, of this User's Manual before using the emulator product. Incorrect operation will damage the user system and the emulator product. This emulator is an efficient development tool for software and hardware of user systems based on Hitachi's original microprocessor. The emulator operates using the Hitachi debugging interface (hereafter referred to as the HDI), which is the interface program that runs on Microsoft(R) Windows(R) 98, Microsoft(R) Windows(R) Me, Microsoft(R) Windows(R) 2000, or Microsoft(R) Windows NT(R) operating system. This manual describes the functions and operating procedures of the E10A emulator. Sections 1 to 5 describe common features of all types of E10A emulators. Section 6 describes supplements to the E10A emulator. Read section 1.1, Warnings, carefully before using the emulator. This manual consists of six sections. The information contained in each section is summarized below: * Section 1, Overview, gives the emulator overview. * Section 2, Preparation before Use, gives instructions for first-time users, such as preparation before use and system connection. * Section 3, Tutorial, describes HDI operating examples and functions. * Section 4, Descriptions of Windows, describes HDI windows for operating the emulator. * Section 5, Command-line Functions describes how to input HDI commands and command types. * Section 6, SHxxxx E10A Emulator Specifications describes the detailed specifications and the features of the E10A emulator for each device. Section 7 describes the important information of the E10A emulator according to emulator products. Read these sections before using the E10A emulator. The HDI installation disks are provided by the CD-R. Refer to the descriptions in the manuals of the host computer or operating system. i Related Manuals: * SH Series Cross Assembler User's Manual * H Series Linkage Editor User's Manual * H Series Librarian User's Manual * SuperH RISC Engine C/C++ Compiler User's Manual * Hitachi Debugging Interface User's Manual * Hardware Manual for each device * Programming Manual for each device Notes: 1. IBM PC is a registered trademark of International Business Machines Corporation. 2. Microsoft(R), Windows(R), and Windows NT(R) are registered trademarks of Microsoft Corporation in the United States and/or other countries. Microsoft(R) Windows(R) 98 operating system is referred to as Windows(R) 98 in this user's manual. Microsoft(R) Windows(R) Millennium Edition operating system is referred to as (R) Windows Me in this user's manual. (R) (R) (R) Microsoft Windows 2000 operating system is referred to as Windows 2000 in this user's manual. Adobe, Acrobat, and Acrobat Reader are registered trademarks of Adobe Systems Incorporated. Other brand and product names are registered trademarks of each company. 3. 4. ii Contents Section 1 Overview............................................................................................1 1.1 1.2 1.3 Warnings ........................................................................................................................... 3 Environmental Conditions ................................................................................................ 4 Components ...................................................................................................................... 6 Section 2 Preparation before Use ........................................................................7 2.1 Emulator Preparation ........................................................................................................... 7 2.2 HDI Installation ................................................................................................................... 8 2.2.1 Installing under Windows(R)98 and Windows(R)Me Operating Systems................. 8 2.2.2 Installing under Windows NT(R)4.0 Operating System ......................................... 9 2.2.3 Installing under Windows(R)2000 Operating System ............................................ 10 2.3 Connecting the Card Emulator to the Host Computer ......................................................... 11 2.4 Connecting the Card Emulator to the User System ............................................................. 12 2.5 System Check ...................................................................................................................... 15 2.6 Ending the HDI.................................................................................................................... 21 2.7 Uninstalling the HDI......................................................................................................... 22 2.8 CD-R.................................................................................................................................... 23 2.8.1 Configuration of the CD-R .................................................................................... 23 2.9 Support ................................................................................................................................ 23 Section 3 Tutorial ................................................................................................25 3.1 3.2 3.3 3.4 3.5 3.6 3.7 Introduction....................................................................................................................... 25 Running the HDI............................................................................................................... 27 [HDI] Window .................................................................................................................. 28 Setting up the Emulator .................................................................................................... 29 Setting the [Configuration] Dialog Box............................................................................ 30 Checking the Operation of the Target Memory for Downloading.................................... 31 Downloading the Tutorial Program .................................................................................. 33 3.7.1 Downloading the Tutorial Program ..................................................................... 33 3.7.2 Displaying the Source Program ........................................................................... 34 Setting a Software Breakpoint .......................................................................................... 36 Setting Registers ............................................................................................................... 37 Executing the Program...................................................................................................... 39 Reviewing Breakpoints ..................................................................................................... 41 Viewing Memory .............................................................................................................. 42 Watching Variables........................................................................................................... 43 Stepping Through a Program ............................................................................................ 46 3.14.1 Executing [Step In] Command............................................................................. 46 3.14.2 Executing [Step Out] Command .......................................................................... 48 iii 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.14.3 Executing [Step Over] Command ........................................................................ 50 3.15 Forced Breaking of Program Executions .......................................................................... 52 3.16 Displaying Local Variables............................................................................................... 53 3.17 Break Function.................................................................................................................. 54 3.17.1 Software Break Function ..................................................................................... 54 3.18 Hardware Break Function ................................................................................................. 60 3.18.1 Setting the Sequential Break Condition ............................................................... 68 3.19 Trace Functions................................................................................................................. 73 3.19.1 Internal Trace Function........................................................................................ 75 3.19.2 AUD Trace Function............................................................................................ 77 3.19.3 VP_MAP Translation........................................................................................... 79 3.20 Stack Trace Function ........................................................................................................ 82 3.21 Profiling Function ............................................................................................................. 84 3.22 Download Function to the Flash Memory Area ................................................................ 89 3.23 What Next? ....................................................................................................................... 95 Section 4 Descriptions of Windows....................................................................97 4.1 4.2 HDI Windows ................................................................................................................... 97 Descriptions of Each Window .......................................................................................... 100 4.2.1 [Configuration] Dialog Box................................................................................. 100 4.2.2 [Breakpoints] Window......................................................................................... 108 4.2.3 [Break] Dialog Box.............................................................................................. 111 4.2.4 [Break Point] Dialog Box .................................................................................... 117 4.2.5 [Break Condition] Dialog Box............................................................................. 119 4.2.6 [Break Condition] Dialog Box Pages................................................................... 121 4.2.7 [Trace] Window................................................................................................... 133 4.2.8 [Trace Acquisition] Dialog Box........................................................................... 135 4.2.9 [System Status] Window...................................................................................... 138 Section 5 Command-line Functions....................................................................141 5.1 Table and Symbol Description.......................................................................................... 141 5.1.1 Format.................................................................................................................. 141 5.1.2 Parameter Input.................................................................................................... 141 5.1.3 Examples.............................................................................................................. 142 5.1.4 Related Items ....................................................................................................... 142 Command Descriptions..................................................................................................... 143 5.2.1 AUD_CLOCK:AUCL ......................................................................................... 145 5.2.2 AUD_MODE:AUM............................................................................................. 147 5.2.3 AUD_TRACE:AUT............................................................................................. 149 5.2.4 BREAKCONDITION_CLEAR: BCC ................................................................. 151 5.2.5 BREAKCONDITION_DISPLAY: BCD ............................................................. 152 5.2.6 BREAKCONDITION_ENABLE: BCE............................................................... 153 5.2.7 BREAKCONDITION_SET: BCS ....................................................................... 154 5.2 iv 5.2.8 5.2.9 5.2.10 5.2.11 5.2.12 5.2.13 5.2.14 5.2.15 5.2.16 5.2.17 5.2.18 5.2.19 5.2.20 5.2.21 5.2.22 5.2.23 5.2.24 5.2.25 BREAKPOINT: BP ............................................................................................. 158 BREAKPOINT_CLEAR: BC .............................................................................. 160 BREAKPOINT_DISPLAY: BD .......................................................................... 162 BREAKPOINT_ENABLE: BE ........................................................................... 163 DEVICE_TYPE: DE ........................................................................................... 165 GO_OPTION: GP................................................................................................ 166 JTAG_CLOCK: JCK ........................................................................................... 168 MEMORYAREA_SET: MAS ............................................................................. 170 REFRESH: RF ..................................................................................................... 172 RESTART: RST .................................................................................................. 173 STATUS: STS ..................................................................................................... 174 STEP_INTERRUPT: SI....................................................................................... 175 TRACE_DISPLAY: TD ...................................................................................... 176 UBC_MODE:UM ................................................................................................ 178 VPMAP_CLEAR: VC ......................................................................................... 179 VPMAP_DISPLAY: VD ..................................................................................... 180 VPMAP_ENABLE: VE....................................................................................... 181 VPMAP_SET: VS ............................................................................................... 182 Section 6 SH7290 E10A Emulator Specifications..............................................183 6.1 6.2 6.3 6.4 6.5 Components of the Emulator ............................................................................................ 183 Pin Arrangement of the Hitachi-UDI Port Connector....................................................... 186 User System Interface Circuit ........................................................................................... 190 Differences between the SH7290 and the Emulator ......................................................... 196 Specific Functions for the SH7290 E10A Emulator ......................................................... 200 6.5.1 Emulator Driver Selection ................................................................................... 200 6.5.2 Break Condition Functions .................................................................................. 201 6.5.3 Trace Functions.................................................................................................... 202 6.5.4 Notes on Using the JTAG Clock (TCK) and AUD Clock (AUDCK) ................. 209 6.5.5 Notes on Setting the [Breakpoint] Dialog Box .................................................... 209 6.5.6 Notes on Setting the [Break Condition] Dialog Box ........................................... 210 6.5.7 Notes on Setting the BREAKCONDITION_SET Command .............................. 211 6.5.8 Notes on Setting the [Trace] Window.................................................................. 211 6.5.9 Notes on Setting the UBC_MODE Command..................................................... 211 6.5.10 Performance Measurement Function ................................................................... 212 6.5.11 Notes on U Standby State .................................................................................... 217 6.5.12 Downloading to the Flash Memory ..................................................................... 220 6.5.13 Notes on HDI ....................................................................................................... 222 v Figures Figure 1.1 Figure 1.2 Figure 2.1 Figure 2.2 Figure 2.3 Figure 2.4 System Configuration with the Emulator (PCMCIA Card Emulator Used)............. 1 System Configuration with the Emulator (PCI Card Emulator Used)...................... 2 Emulator Preparation Flow Chart............................................................................. 7 Inserting the PCMCIA Card Emulator in the Host Computer's Slot ....................... 11 Inserting the PCI Card Emulator in the Host Computer's Slot ................................ 11 Connecting the User System Interface Cable to the User System when the 14-pin Straight Type Connector is Used................................................. 13 Figure 2.5 User System Example .............................................................................................. 14 Figure 2.6 [Start] Menu ............................................................................................................. 15 Figure 2.7 [Select Session] Dialog Box..................................................................................... 16 Figure 2.8 [E10A Driver Details] Dialog Box........................................................................... 17 Figure 2.9 Dialog Box of the RESET Signal Input Request Message....................................... 18 Figure 2.10 [HDI] Status Bar..................................................................................................... 18 Figure 2.11 [JTAG Connector Disconnected] Dialog Box........................................................ 18 Figure 2.12 [Can not find /RESET signal] Dialog Box ............................................................. 19 Figure 2.13 [Check the connection] Dialog Box ....................................................................... 19 Figure 2.14 [COMMUNICATION TIMEOUT ERROR] Dialog Box ...................................... 19 Figure 2.15 [INVALID ASERAM FIRMWARE!] Dialog Box ................................................ 20 Figure 2.16 [Error JTAG boot] Dialog Box .............................................................................. 20 Figure 2.17 [Unable to restore the previous driver settings] Dialog Box .................................. 20 Figure 2.18 [Exit HDI] Dialog Box ........................................................................................... 21 Figure 2.19 [Save session] Dialog Box ..................................................................................... 21 Figure 3.1 [Start] Menu ............................................................................................................. 27 Figure 3.2 [HDI] Window ......................................................................................................... 28 Figure 3.3 [Configuration] Dialog Box ..................................................................................... 30 Figure 3.4 [Open Memory Window] Dialog Box...................................................................... 31 Figure 3.5 [Memory] Window................................................................................................... 31 Figure 3.6 [Load Program] Dialog Box..................................................................................... 33 Figure 3.7 [HDI] Dialog Box..................................................................................................... 33 Figure 3.8 [Open] Dialog Box ................................................................................................... 34 Figure 3.9 [Source] Window (Displaying the Source Program)................................................ 35 Figure 3.10 [Source] Window (Setting a Software Breakpoint)................................................ 36 Figure 3.11 [Registers] Window................................................................................................ 37 Figure 3.12 [Register] Dialog Box (PC) .................................................................................... 38 Figure 3.13 [Go] Button ............................................................................................................ 39 Figure 3.14 [Source] Window (Break Status)............................................................................ 39 Figure 3.15 [System Status] Window ........................................................................................ 40 Figure 3.16 [Breakpoints] Window ........................................................................................... 41 Figure 3.17 [Open Memory Window] Dialog Box.................................................................... 42 Figure 3.18 [Memory] Window................................................................................................. 42 Figure 3.19 [Instant Watch] Dialog Box ................................................................................... 43 Figure 3.20 [Watch] Window (Displaying the Array)............................................................... 44 vi Figure 3.21 Figure 3.22 Figure 3.23 Figure 3.24 Figure 3.25 Figure 3.26 Figure 3.27 Figure 3.28 Figure 3.29 Figure 3.30 Figure 3.31 Figure 3.32 Figure 3.33 Figure 3.34 Figure 3.35 Figure 3.36 Figure 3.37 Figure 3.38 Figure 3.39 Figure 3.40 Figure 3.41 Figure 3.42 Figure 3.43 Figure 3.44 Figure 3.45 Figure 3.46 Figure 3.47 Figure 3.48 Figure 3.49 Figure 3.50 Figure 3.51 Figure 3.52 Figure 3.53 Figure 3.54 Figure 3.55 Figure 3.56 Figure 3.57 Figure 3.58 Figure 3.59 Figure 3.60 Figure 3.61 Figure 3.62 Figure 3.63 [Add Watch] Dialog Box ....................................................................................... 44 [Watch] Window (Displaying the Variable) .......................................................... 45 [Watch] Window (Displaying Array Elements) ..................................................... 45 [Step In] Button...................................................................................................... 46 [Source] Window (Step In) .................................................................................... 47 [Step Out] Button ................................................................................................... 48 [HDI] Window (Step Out)...................................................................................... 48 [HDI] Window (Step In -> Step In)....................................................................... 49 [Source] Window (Before Step Over Execution)................................................... 50 [Step Over] Button ................................................................................................. 50 [HDI] Window (Step Over).................................................................................... 51 [Go] Button ............................................................................................................ 52 [Stop] Button .......................................................................................................... 52 [Locals] Window.................................................................................................... 53 [Breakpoints] Window (Before Software Breakpoint Setting) .............................. 54 [Point] Page ([Break] Dialog Box)......................................................................... 55 [Break Point] Dialog Box....................................................................................... 56 [Point] Page ([Break] Dialog Box) (After Software Breakpoint Setting) .............. 57 [Breakpoints] Window (Software Breakpoint Setting) .......................................... 58 [Source] Window at Execution Stop (Software Break).......................................... 58 Displayed Contents of the [System Status] Window (Software Break) ................. 59 [Breakpoints] Window (Before Hardware Break Condition Setting) .................... 60 [Condition] Page ([Break] Dialog Box) ................................................................. 61 [Address] Page ([Break Condition 1] Dialog Box) ................................................ 62 [Bus State] Page ([Break Condition 1] Dialog Box) .............................................. 63 [Break] Dialog Box (After Hardware Break Condition Setting)............................ 64 [Breakpoints] Window ([Break Condition 1] Setting) ........................................... 65 [Source] Window at Execution Stop (Break Condition 1) ..................................... 66 Displayed Contents of the [System Status] Window (Break Condition 1)............. 67 [Configuration] Dialog Box (Sequential Break Setting) ........................................ 69 [Breakpoints] Window (After Sequential Break Condition Setting)...................... 70 [Source] Window at Execution Stop (Sequential Break) ....................................... 71 Displayed Contents of the [System Status] Window (Sequential Break)............... 72 [Trace mode] Window ........................................................................................... 75 [Trace] Window ..................................................................................................... 76 [Trace mode] Window ........................................................................................... 77 [Trace] Window in the SH7751 E10A Emulator ................................................... 78 Address Translation according to VP_MAP Tables............................................... 80 [Source] Window (Software Breakpoint Setting) .................................................. 82 [Stack Trace] Window............................................................................................ 83 [Profile-List] Window ............................................................................................ 84 Selection of [Enable Profiler]................................................................................. 85 [Select Data] Dialog Box ....................................................................................... 86 vii Figure 3.64 [Source] Window (Software Break Setting)........................................................... 87 Figure 3.65 [Profile-List] Window ............................................................................................ 87 Figure 3.66 [Profile-Tree] Window ........................................................................................... 88 Figure 3.67 [Profile-Chart] Window ......................................................................................... 88 Figure 3.68 [Loading flash memory] Page ................................................................................ 90 Figure 3.69 Flash Memory Wiring ............................................................................................ 92 Figure 3.70 [Loading flash memory] Page ................................................................................ 93 Figure 4.1 [Configuration] Dialog Box ..................................................................................... 100 Figure 4.2 [General] Page ([Configuration] Dialog Box).......................................................... 102 Figure 4.3 Warning Message Box ............................................................................................. 104 Figure 4.4 [E10A Driver Details] Dialog Box........................................................................... 105 Figure 4.5 [Loading flash memory] Page ([Configuration] Dialog Box) .................................. 106 Figure 4.6 [Breakpoints] Window ............................................................................................. 108 Figure 4.7 [Break] Dialog Box .................................................................................................. 111 Figure 4.8 [Point] Page ([Break] Dialog Box)........................................................................... 113 Figure 4.9 [Condition] Page ([Break] Dialog Box) ................................................................... 115 Figure 4.10 [Break Point] Dialog Box....................................................................................... 117 Figure 4.11 [Break Condition] Dialog Box ............................................................................... 119 Figure 4.12 [Address] Page ([Break Condition 1] Dialog Box) ................................................ 123 Figure 4.13 [Data] Page ([Break Condition 1] Dialog Box)...................................................... 125 Figure 4.14 [ASID] Page ([Break Condition] Dialog Box) ....................................................... 127 Figure 4.15 [Bus State] Page ([Break Condition] Dialog Box) ................................................. 128 Figure 4.16 [Count] Page ([Break Condition] Dialog Box) ...................................................... 130 Figure 4.17 [General] Page ([Break Condition] Dialog Box)..................................................... 131 Figure 4.18 [Trace] Window ..................................................................................................... 133 Figure 4.19 [Trace mode] Page ([Trace Acquisition] Dialog Box) ........................................... 136 Figure 4.20 [System Status] Window ........................................................................................ 138 Figure 5.1 TLB Error Message Dialog ...................................................................................... 176 Figure 6.1 Connecting Ferrite Core ........................................................................................... 185 Figure 6.2 Pin Arrangement of the Hitachi-UDI Port Connector (14 Pins)............................... 186 Figure 6.3 Pin Arrangement of the Hitachi-UDI Port Connector (36 Pins)............................... 188 Figure 6.4 User System Interface Circuit (HS7290KCM01H) (Model Name: HS0005KCM07H) ......................................................................... 190 Figure 6.5 User System Interface Circuit of the Hitachi-UDI Pin (HS7290KCM02H) (Model Name: HS0005KCM08H) ......................................................................... 191 Figure 6.6 User System Interface Circuit of the AUD Pin (HS7290KCM02H) (Model Name: HS0005KCM08H) ......................................................................... 192 Figure 6.7 User System Interface Circuit (HS7290KCI01H) (Model Name: HS0005KCI07H) ........................................................................... 193 Figure 6.8 User System Interface Circuit of the Hitachi-UDI Pin (HS7290KCI02H) (Model Name: HS0005KCI08H) ........................................................................... 194 Figure 6.9 User System Interface Circuit of the AUD Pin (HS7290KCI02H) (Model Name: HS0005KCI08H) ........................................................................... 195 viii Figure 6.10 Figure 6.11 Figure 6.12 Figure 6.13 Figure 6.14 Figure 6.15 Figure 6.16 Figure 6.17 Figure 6.18 [Trace mode] Page ................................................................................................. 204 [Window trace] Page .............................................................................................. 205 [Trace] Window ..................................................................................................... 207 [HDI] Message Box................................................................................................ 211 [Performance 1] Dialog Box .................................................................................. 213 [Performance Analysis] Window ........................................................................... 217 [Recovery Information] Page ................................................................................. 218 Message Box for Entering the U Standby State ..................................................... 219 Example of Connecting the Flash Memory............................................................ 221 ix Tables Table 1.1 Environmental Conditions ......................................................................................... 4 Table 1.2 Operating Environments............................................................................................ 5 Table 2.1 Recommended Hitachi-UDI Port Connector ............................................................. 12 Table 2.2 Contents of the CD-R Directories.............................................................................. 23 Table 3.1 Tutorial Program: Configuration and Parts ............................................................... 25 Table 3.2 Step Option ................................................................................................................ 46 Table 3.3 Sequential Break Conditions ..................................................................................... 68 Table 3.4 AUD Trace Functions................................................................................................ 74 Table 3.5 Address Translation Tables ....................................................................................... 81 Table 3.6 Module Interface........................................................................................................ 89 Table 3.7 [Loading flash memory] Page Options...................................................................... 91 Table 3.8 Example of Board Specifications .............................................................................. 92 Table 3.9 Sample Program Specifications ................................................................................. 93 Table 4.1 HDI Window Menus and Related Manual Entries .................................................... 97 Table 4.2 [Configuration] Dialog Box Page .............................................................................. 101 Table 4.3 [General] Page Options.............................................................................................. 103 Table 4.4 Options for the [E10A Driver Details] Dialog Box ................................................... 105 Table 4.5 [Loading flash memory] Page Options...................................................................... 107 Table 4.6 [Breakpoints] Window Display Items ....................................................................... 109 Table 4.7 [Breakpoints] Window Pop-up Menu Operation....................................................... 110 Table 4.8 [Break] Dialog Box Pages ......................................................................................... 112 Table 4.9 [Point] Page Options.................................................................................................. 114 Table 4.10 [Condition] Page Options ........................................................................................ 116 Table 4.11 [Address] Page Options ........................................................................................... 118 Table 4.12 Setting Conditions in [Break Condition] Dialog Boxes........................................... 121 Table 4.13 [Break Condition] Dialog Box Pages ...................................................................... 122 Table 4.14 [Address] Page Options ........................................................................................... 124 Table 4.15 Address Options ...................................................................................................... 124 Table 4.16 [Data] Page Options................................................................................................. 126 Table 4.17 [ASID] Page Options............................................................................................... 127 Table 4.18 [Bus State] Page Options ......................................................................................... 129 Table 4.19 [Count] Page Options .............................................................................................. 130 Table 4.20 [General] Page Options............................................................................................ 132 Table 4.21 [Trace] Window Display Items................................................................................ 134 Table 4.22 [Trace Acquisition] Dialog Box Page Options ........................................................ 135 Table 4.23 [Trace mode] Page Options ..................................................................................... 137 Table 4.24 [System Status] Window Display Items .................................................................. 139 Table 5.1 E10A HDI Commands............................................................................................... 143 Table 5.2 AUD_CLOCK Command Parameter ........................................................................ 145 Table 5.3 AUD_MODE Command Parameter .......................................................................... 147 Table 5.4 AUD_TRACE Command Parameter......................................................................... 149 Table 5.5 BREAKCONDITION_CLEAR Command Parameter .............................................. 151 x Table 5.6 BREAKCONDITION_DISPLAY Command Parameter .......................................... 152 Table 5.7 BREAKCONDITION_ENABLE Command Parameters.......................................... 153 Table 5.8 BREAKCONDITION_SET Command Parameters .................................................. 155 Table 5.9 BREAKPOINT Command Parameters...................................................................... 158 Table 5.10 BREAKPOINT_CLEAR Command Parameters..................................................... 160 Table 5.11 BREAKPOINT_DISPLAY Command Parameter................................................... 162 Table 5.12 BREAKPOINT_ENABLE Command Parameters .................................................. 163 Table 5.13 DEVICE_TYPE Command Parameter .................................................................... 165 Table 5.14 GO_OPTION Command Parameter ........................................................................ 166 Table 5.15 JTAG_CLOCK Command Parameter ..................................................................... 168 Table 5.16 MEMORYAREA_SET Command Parameters ....................................................... 170 Table 5.17 REFRESH Command Parameter ............................................................................. 172 Table 5.18 RESTART Command Parameter............................................................................. 173 Table 5.19 STATUS Command Parameter ............................................................................... 174 Table 5.20 STEP_INTERRUPT Command Parameter ............................................................. 175 Table 5.21 TRACE_DISPLAY Command Parameter............................................................... 176 Table 5.22 UBC_MODE Command Parameter......................................................................... 178 Table 5.23 VPMAP_CLEAR Command Parameter.................................................................. 179 Table 5.24 VPMAP_DISPLAY Command Parameter .............................................................. 180 Table 5.25 VPMAP_ENABLE Command Parameter ............................................................... 181 Table 5.26 VPMAP_SET Command Parameters ...................................................................... 182 Table 6.1 Components of the Emulator (HS7290KCM01H, HS7290KCM02H, HS7290KCI01H, or HS7290KCI02H)................................................................... 184 Table 6.2 Register Initial Values at Emulator Power-On .......................................................... 196 Table 6.3 Multiplexed Functions ............................................................................................... 198 Table 6.4 Type Number and Driver........................................................................................... 199 Table 6.5 Types of Break Conditions ........................................................................................ 200 Table 6.6 Dialog Boxes for Setting Break Conditions............................................................... 201 Table 6.7 Trace Functions ......................................................................................................... 201 Table 6.8 Type Number and AUD Function ............................................................................. 201 Table 6.9 AUD Trace Acquisition Mode................................................................................... 202 Table 6.10 [Trace] Window Display Contents .......................................................................... 206 Table 6.11 Conditions Specified in [Mode]............................................................................... 211 Table 6.12 Measurement Item ................................................................................................... 212 Table 6.13 Performance Measurement Conditions to be Counted ............................................ 213 Table 6.14 Selected Items in the [Recovery Information] Page ................................................ 215 Table 6.15 Watchdog Timer Register........................................................................................ 220 xi xii Section 1 Overview The E10A emulator (hereafter referred to as the emulator) is a software and hardware development support tool for application systems using the microprocessor developed by Hitachi, Ltd. The PCMCIA card emulator or PCI card emulator (hereafter referred to as the card emulator), which is the main unit of the emulator, is connected, through the Hitachi-UDI (user debug interface) port*, to the user system. The user system can be debugged under the conditions similar to the actual application conditions. The emulator enables debugging anywhere indoors or out. The host computer for controlling the emulator must be an IBM PC compatible machine with a PCMCIA type II or PCI slot. Figures 1.1 and 1.2 show the system configuration using the emulator. Note: The Hitachi-UDI is an interface based on the Joint Test Action Group (JTAG) specifications. PC PC Card Figure 1.1 System Configuration with the Emulator (PCMCIA Card Emulator Used) 1 Figure 1.2 System Configuration with the Emulator (PCI Card Emulator Used) The emulator provides the following features: * Excellent cost-performance card emulator Compactness and low price are implemented using the PCMCIA interface or the PCI interface. * Realtime emulation Realtime emulation of the user system is enabled at the maximum operating frequency of the CPU. * Excellent operability Using the Hitachi Debugging Interface (HDI) on the Microsoft Windows 98, Microsoft (R) (R) (R) (R) (R) Windows Me, Microsoft Windows 2000, and Microsoft Windows NT operating systems enables user program debugging using a pointing device such as a mouse. The HDI enables high-speed downloading of load module files. * Various debugging functions Various break and trace functions enable efficient debugging. Breakpoints and break conditions can be set by the specific window, trace information can be displayed on a window, and command-line functions can be used. * Memory access during emulation During emulation, the memory contents can be read and modified. * Debugging of the user system in the final development stage The user system can be debugged under conditions similar to the actual application conditions. * Compact debugging environment When the card emulator specific to the PCMCIA interface is used, a laptop computer can be used as a host computer, creating a debugging environment in any place. (R) (R) (R) 2 * AUD trace function* The AUD trace function enables realtime trace. Note: The AUD is an abbreviation of the Advanced User Debugger. Support for the AUD varies with the product. 1.1 Warnings CAUTION READ the following warnings before using the emulator product. Incorrect operation will damage the user system and the emulator product. The USER PROGRAM will be LOST. 1. Check all components against the component list after unpacking the emulator. 2. Never place heavy objects on the casing. 3. Protect the emulator from excessive impacts and stresses. For details, refer to section 1.2, Environmental Conditions. 4. Do not insert the emulator into any slot (PCMCIA TYPE II slot or PCI slot) other than the specified one. 5. When moving the host computer or user system, take care not to vibrate or damage it. 6. After connecting the cable, check that it is connected correctly. For details, refer to section 2, Preparation before Use. 7. Supply power to the connected equipment after connecting all cables. Cables must not be connected or removed while the power is on. 3 1.2 Environmental Conditions CAUTION Observe the conditions listed in tables 1.1 and 1.2 when using the emulator. Failure to do so will cause illegal operation in the user system, the emulator product, and the user program. Table 1.1 Environmental Conditions Item Temperature Humidity Vibration Specifications Operating: +10C to +35C Storage: -10C to +50C Operating: 35% RH to 80% RH, no condensation Storage: 35% RH to 80% RH, no condensation Operating: 2.45 m/s max. 2 Storage: 4.9 m/s max. 2 Transportation: 14.7 m/s max. No corrosive gases may be present 2 Ambient gases Table 1.2 lists the acceptable operating environments. 4 Table 1.2 Operating Environments Item Host computer Description Built-in Pentium or higher-performance CPU (200 MHz or higher recommended); IBM PC or compatible machine with the PCMCIA TYPE II slot or the PCI slot. Windows 98, Windows Me, Windows 2000, or Windows NT (R) (R) (R) (R) OS Minimum memory capacity Hard-disk capacity 32 Mbytes or more (double of the load module size recommended) Installation disk capacity: 10 Mbytes or more. (Prepare an area at least double the memory capacity (four-times or more recommended) as the swap area.) Connectable to the host computer; compatible with Windows 98, (R) (R) (R) Windows Me, Windows 2000, and Windows NT . 5.0 0.25 V HSxxxxKCM01H: 110 mA (max) HSxxxxKCM02H: 230 mA (max) HSxxxxKCI01H: 340 mA (max) HSxxxxKCI02H: 600 mA (max) Required to install the HDI for the emulator or refer to the emulator user's manual. (R) Pointing device such as mouse Power voltage Current consumption CD-ROM drive 5 1.3 Components Check all the components unpacking. For details on the E10A emulator components, refer to section 6.1, Components of the Emulator. If the components are not complete, contact a Hitachi sales agency. 6 Section 2 Preparation before Use 2.1 Emulator Preparation WARNING READ the reference sections shaded in figure 2.1 before using the emulator product. Incorrect operation will damage the user system and the emulator product. The USER PROGRAM will be LOST. Unpack the emulator and prepare it for use as follows: Reference Unpack the emulator Check the components against the component list When the emulator is used first. Component list Set up the emulator - Install the HDI - Insert the card emulator Section 2 Start the HDI Turn on the user system Input the user system reset signal Section 3 When the emulator is used for second time or later. Figure 2.1 Emulator Preparation Flow Chart 7 2.2 HDI Installation When the CD-R is inserted in the host computer's CD-ROM drive, the HDI installation wizard is automatically activated (holding the Shift key down while the CD-R is inserted cancels this automatic activation). To run the installation wizard when it has not been automatically activated, execute Setup.exe from the root directory of the CD-R. Follow the cues given by the installation wizard to install the HDI. Since hardware settings are also made during installation, the installation procedure differs according to the operating system or interface (PCI or PCMCIA) being used. Follow the installation steps carefully according to the environment you are using. 2.2.1 Installing under Windows(R)98 and Windows(R)Me Operating Systems (1) When the emulator is a PCI card: 1. 2. 3. 4. Install the HDI (when the component type has to be selected during installation, be sure to select [PCI Card Driver]). Shut the operating system down and turn off the power to the host computer. Insert the PCI-card emulator in a slot on the host computer. Refer to section 2.3, Connecting the Card Emulator to the Host Computer. Restart the host computer. The hardware is now recognized and the driver is automatically installed.* Install the HDI (when the component type has to be selected during installation, be sure to select [PC Card Driver (PCMCIA)]). Insert the PCMCIA-card emulator in the host computer's slot. Refer to section 2.3, Connecting the Card Emulator to the Host Computer. The hardware is now recognized and the driver is automatically installed.* (2) When the emulator is a PCMCIA card: 1. 2. 3. Note: When [Add New Hardware Wizard] is displayed, select the [Search for the best driver for your device. (Recommended)] radio button and then the [Specify a location] check box to select the path to be searched for drivers. The location must be specified according to the emulator type, as indicated below: When using the PCI-card emulator: 8 2.2.2 Installing under Windows NT(R)4.0 Operating System (1) When the emulator is a PCI card: 1. Shut the operating system down and turn off the power to the host computer. 2. Insert the PCI-card emulator in a slot on the host computer. Refer to section 2.3, Connecting the Card Emulator to the Host Computer. 3. Start the host computer and log-on with an administrator-level user name. 4. Install the HDI. (For a component, be sure to select [PCI Card Driver]. There is a check box for selecting the type name of the product under the [PCI Card Driver] component. Select the appropriate type name. If the correct name is not selected, the correct driver will not be installed, and the emulator will not operate.) 5. Restart the host computer. (2) When the emulator is a PCMCIA card: 1. Shut the operating system down and turn off the power to the host computer. 2. Insert the PCMCIA-card emulator in the host computer's slot. Refer to section 2.3, Connecting the Card Emulator to the Host Computer. 3. Start the host computer and log-on with an administrator-level user name. 4. During HDI installation, the setting value should be checked beforehand because inquiries are made about the resource used by the PCMCIA-card emulator. Start the [Start] menu -> [Programs] -> [Administrative Tools (Common)] -> [Windows NT Diagnostics], check the status of the IRQ, I/O port, and memory from the resource panel, and determine the setting values that do not conflict with other devices. (The following resources are used: IRQ: one channel, I/O port: H'F byte, and memory: H'4000 byte.) 5. Install the HDI. (For a component, be sure to select [PC Card Driver (PCMCIA)]. There is a check box for selecting the type name of each product under the [PC Card Driver (PCMCIA)] component. Select the appropriate type name. If the correct name is not selected, the correct driver will not be installed and the emulator will not operate.) 6. Restart the host computer. Notes: 1. For the SH7729, SH7729R, and SH7622 E10A emulators, there is a check box for selecting the MODEL name that appears on the component list. Select the correct type name. 2. The driver that has been selected in the [Drivers] component starts after the host computer is initiated. If the host computer is initiated with the card disconnected or with the incorrect driver installed, the driver cannot initiate and the service control manager informs the system of an error. This, however, is not a problem. 9 2.2.3 Installing under Windows(R)2000 Operating System (1) When the emulator is a PCI card: 1. 2. 3. 4. 5. Log-on with an administrator-level user name. Install the HDI. (When a component is selected, be sure to select [PCI Card Driver].) Shut the operating system down and turn off the power to the host computer. Insert the PCI-card emulator in a slot on the host computer. Refer to section 2.3, Connecting the Card Emulator to the Host Computer. Restart the host computer and log-on with an administrator-level user name. The hardware is now recognized and the driver is automatically installed.* (2) When the emulator is a PCMCIA card: 1. 2. 3. 4. Log-on with an administrator-level user name. Install the HDI. (When a component is selected, be sure to select [PC Card Driver (PCMCIA)].) Insert the PCMCIA-card emulator in the host computer's slot. Refer to section 2.3, Connecting the Card Emulator to the Host Computer. The hardware is now recognized and the driver is automatically installed.* Note: When [Found New Hardware Wizard] is displayed, select the [Search for a suitable driver for my device (recommended).] radio button and then the [Specify a location] check box to select the path to be searched for drivers. The location must be specified according to the emulator type, as indicated below: When using the PCI-card emulator: 10 2.3 Connecting the Card Emulator to the Host Computer Insert the card emulator, according to its type, in a PCMCIA TYPE II slot or PCI slot on the host computer (figures 2.2 and 2.3). Note: When using Windows(R)98, Windows(R)Me, or Windows(R)2000, be sure to install the HDI before putting the card emulator in place. Figure 2.2 Inserting the PCMCIA Card Emulator in the Host Computer's Slot Figure 2.3 Inserting the PCI Card Emulator in the Host Computer's Slot Use the procedure, described in section 2.4, to connect the emulator to the user system with the user system interface cable, or to disconnect them when moving the emulator or the user system. 11 WARNING When inserting the PCI-card emulator, note the following. Failure to do so will damage the host computer. 1. Turn off the host computer. 2. Insert the emulator into the PCI slot in parallel. 3. Screw in the emulator after checking the connector and cable positions. 2.4 Connecting the Card Emulator to the User System (1) The Hitachi-UDI port connector must be installed to the user system. Table 2.1 shows the recommended Hitachi-UDI port connector for the emulator. Table 2.1 Recommended Hitachi-UDI Port Connector Connector 14-pin connector 36-pin connector Type Number 2514-6002 DX10M-36S DX10M-36SE, DX10GM-36SE Manufacturer Minnesota Mining & Manufacturing Ltd. Hirose Electric Co., Ltd. Specifications 14-pin straight type Screw type Lock-pin type Note: When the 14-pin connector is used, do not install any components within 3 mm of the Hitachi-UDI port connector. When the 36-pin connector is used, do not connect other signal lines to the HitachiUDI port connector. (2) Note that the TDO signal of the user system interface cable connector must be connected to the TDI pin of the Hitachi-UDI port connector and the TDI signal of the user system interface cable connector must be connected to the TDO pin of the Hitachi-UDI port connector. Section 6.2 shows the pin arrangement of the Hitachi-UDI port connector. (3) Figure 2.4 shows how to connect the user system interface cable to the user system when the 14-pin straight type connector is used. Connect the ground line of the cable to the user system ground. The end of the ground line has a hole having a diameter of 3 mm, and therefore, when the ground line is screwed to the user system, the screw diameter must be 3 mm. 12 Figure 2.4 Connecting the User System Interface Cable to the User System when the 14-pin Straight Type Connector is Used Notes: 1. 2. 3. To connect the signals output from the Hitachi-UDI port connector, refer to the device pin alignment. To remove the user system interface cable from the user system, pull the tab on the connector upward. The range of frequencies that the Hitachi-UDI operates at is different according to the devices used. For details, refer to section 6.5.4, Notes on Using the JTAG Clock (TCK) and AUD Clock (AUDCK). Connect the Hitachi-UDI signals from the Hitachi-UDI port connector directly to the device. When developing user systems, do not connect the TDI and TDO signals of the device to the boundary scan loop, or separate them by using a switch (figure 2.5). 4. 5. 13 Figure 2.5 User System Example 14 2.5 System Check When the HDI program is executed, use the procedure below to check that the emulator is operating correctly. 1. Check that the emulator card is inserted in the host computer's slot. 2. Connect the user system interface cable to the connector of the card emulator. 3. Connect the user system interface cable to the Hitachi-UDI port connector. 4. Supply power to the host computer and select [HDI for E10A SHxxxx] -> [Hitachi Debugging Interface] from the [Start] menu. Figure 2.6 [Start] Menu 15 5. Select the setting to be used. Figure 2.7 [Select Session] Dialog Box 16 6. The [E10A Driver Details] dialog box is displayed. With the [Driver] combo box, select the driver to connect the HDI with the emulator. [Interface] displays the interface name of the PC interface board to be connected, and [Channel] displays the interface to which the board is connected. Once the driver is selected in the [E10A Driver Details] dialog box, this dialog box is not displayed when the HDI is run next time. (This procedure will not be executed by target devices.) Figure 2.8 [E10A Driver Details] Dialog Box * With the [Driver] combo box, select the driver to connect the HDI with the emulator. * [Interface] displays the interface name of the card emulator to be connected, and [Channel] displays the interface to which the board is connected. [Driver] combo box: Select [E10A PC Card Driver] to use the PCMCIA card emulator. Select [E10A PCI Card Driver] to use the PCI card emulator. For details, refer to table 6.3 in section 6.5.1, Emulator Driver Selection. [Interface] combo box: Select [PC Card] to use the PCMCIA card emulator. [PCI] is displayed to use the PCI card emulator. (If the driver is not installed, the [PC Card] or [PCI] is not displayed.) * Click the [Close] button. 17 7. The HDI window is displayed, and the dialog box is displayed as shown in figure 2.9. Figure 2.9 Dialog Box of the RESET Signal Input Request Message 8. Power on the user system. 9. Input the reset signal from the user system, and click the [OK] button. 10. When "Link Up" is displayed on the status bar, the HDI initiation is completed. Figure 2.10 [HDI] Status Bar Notes: 1. When the HDI is not linked up even if the above procedure has been executed, the driver will not be set correctly. Install drivers provided under the /DRIVERS directory in the CD-R according to the screen instructions. For instructions on how to check the driver has been correctly set, refer to the OS manual for your host computer or the following URL: http://www.hitachi.co.jp/Sicd/English/Products/micom/dev_env/tool/eml/e10a/ she10aqa.htm 2. If the user system interface cable is disconnected to the Hitachi-UDI port connector on the user system during user program execution, the following dialog box will be displayed. Figure 2.11 [JTAG Connector Disconnected] Dialog Box 18 3. If the emulator is not initiated, the following dialog boxes shown in figures 2.12 through 2.16 will be displayed. (a) If the following dialog box is displayed, the power of the user system may not be input or the RESET signal may not be input to the device. Check the input circuits for the power of the user system and the reset pin. Figure 2.12 [Can not find /RESET signal] Dialog Box (b) If the following dialog box is displayed, check that the Hitachi-UDI port connector on the user system is correctly connected. Figure 2.13 [Check the connection] Dialog Box (c) If the following dialog box is displayed, the device may not correctly operate. Check if there are reasons for illegal device operation. Figure 2.14 [COMMUNICATION TIMEOUT ERROR] Dialog Box 19 Figure 2.15 [INVALID ASERAM FIRMWARE!] Dialog Box Figure 2.16 [Error JTAG boot] Dialog Box 4. If the driver is not correctly connected, the following dialog box will be displayed. Figure 2.17 [Unable to restore the previous driver settings] Dialog Box The [E10A Driver Details] dialog box is displayed when the [OK] button is clicked. Select the correct driver. For details, refer to section 6.5.1, Emulator Driver Selection. 20 2.6 Ending the HDI Exit the HDI by using the following procedure: 1. Select [Exit] from the [File] menu to end the HDI. When the [Exit HDI] dialog box is displayed, click the [Yes] button. Figure 2.18 [Exit HDI] Dialog Box 2. Then, the [Save session] dialog box is displayed. If necessary, click the [Yes] button to save session. After saving session, the HDI ends. If not necessary, click the [No] button to end the HDI. Figure 2.19 [Save session] Dialog Box 3. Turn the user system off. 21 2.7 Uninstalling the HDI Follow this procedure to remove the installed HDI from the user's host computer. 1. 2. Open [Add/Remove Programs Properties] from the control panel. Select the HDI program from the list and click the [Add/Remove...] button. The setup program is executed again and the installed application can be changed, modified, or removed. When the application is to be uninstalled, select removal. CAUTION A shared file may be detected while the program is being removed. If another HDI may be using the shared file, do not remove the file. When Microsoft(R) Windows NT(R)4.0 operating system is used, the removal of the registry information on the driver may be asked. If other HDI may use the target driver, do not remove the registry information. If another HDI does not start up after the removal process, re-install that HDI. 22 2.8 CD-R 2.8.1 Configuration of the CD-R The root directory of the CD-R contains a setup program for HDI installation. The folders contain the files and programs listed below. Table 2.2 Contents of the CD-R Directories Directory Name Dlls Contents Microsoft runtime library (R) Description A runtime library for the HDI. The version is checked at installation and this library is copied to the hard disk as part of the installation process. The E10A emulator drivers. An online help file. This is copied to the hard disk as part of the installation process. Precautions on Using the E10A Emulator and the user's manual. These are provided as PDF files. Adobe(R) Acrobat(R) Reader is an application for displaying, viewing, and printing PDF files. Drivers Help Manual E10A emulator driver Online help for the E10A emulator E10A emulator manual Pdf_read Adobe(R) Acrobat(R) Reader setup program 2.9 Support Information on the latest version of the HDI and other supporting information for the emulator can be found on the web site. Access the following URL: http://www.hitachi.co.jp/Sicd/English/Products/micom/dev_env/tool/eml/e10a/e10atop.htm 23 24 Section 3 Tutorial 3.1 Introduction The following describes the main functions of the HDI by using a tutorial program. The tutorial program is based on the C program that sorts ten random data items in ascending or descending order. The tutorial program performs the following actions: * The main function generates random data to be sorted. * The sort function sorts the generated random data in ascending order. * The change function then sorts the data in descending order. The file tutorial.c contains source code for the tutorial program. The file tutorial.abs is a compiled load module in the Dwarf2 format. Table 3.1 is a list of the parts of the tutorial program and an outline of their configuration on the hard disk. Table 3.1 Tutorial Program: Configuration and Parts Item Workspace for HEW V1.2 Load module Main program (source file) Stack information file Contents [Installation directory]\tutorial\tutorial.hws [Installation directory]\tutorial\tutorial\Debug\tutorial.abs [Installation directory]\tutorial\tutorial\tutorial.c [Installation directory]\tutorial\tutorial\Debug\tutorial.sni Use area 3 (CS3 space) as the operating environment. The MMU function is not used. 25 Notes: 1. Operation of tutorial.abs is big endian. For little-endian operation, tutorial.abs must be recompiled. After recompilation, the addresses may differ from those given in this section. 2. This program was created by using Hitachi Embedded Workshop (hereafter referred to as HEW) V1.2. Older versions of HEW will not open the workspace included with the package, so create a new workspace in such situations. This program was compiled without optimization for the SH2 CPU. If recompiled with different settings, the addresses may differ from those given in this section. tutorial.abs is a load module in the Dwarf2 format. If a load module is recreated in the Sysrof format, the amount of information displayed on the HDI screen during the program's execution will be reduced. 3. 4. 5. This section describes general usage examples for the emulator. For the specifications of particular products, refer to section 6 or the online help file. 26 3.2 Running the HDI To run the HDI, select the [HDI for E10A SHxxxx] -> [Hitachi Debugging Interface] from the [Start] menu. Figure 3.1 [Start] Menu For the procedure of running the HDI, refer to section 2.5, System Check. 27 3.3 [HDI] Window Figure 3.2 [HDI] Window The key functions of the HDI are described in section 4, Descriptions of Windows. Numbers in figure 3.2 indicate the following: 1. Menu bar: Gives the user access to the HDI commands for using the HDI debugger. 2. Toolbar: Provides convenient buttons as shortcuts for the most frequently used menu commands. 3. Source window: Displays the source program being debugged. 4. Status bar: Displays the status of the emulator, and progress information about downloading. 5. [Help] button: Activates online help about any features of the HDI user interface. 28 3.4 Setting up the Emulator The clocks which are used for data communications must be set up on the emulator before the program is downloaded. * AUD clock A clock used in acquiring AUD traces. If its frequency is set too low, complete data may not be acquired during realtime tracing. If the frequency is set too high, the upper limit for the device's AUD clock may be exceeded. The AUD clock is only needed for emulators that have an AUD trace function. * JTAG clock (TCK) A communication clock for downloading data to the emulator except for acquiring AUD trace. If its frequency is set too low, the speed of downloading will be lowered. If its frequency is set too high, the upper limit for the device's TCK clock may be exceeded. For details of the limitations on both clocks, refer to section 6.5.4, Notes on Using the JTAG Clock (TCK) and AUD Clock (AUDCK). The following is a description of the procedure used to set the clocks. 29 3.5 Setting the [Configuration] Dialog Box * Select [Configure Platform...] from the [Setup] menu to set a communication clock. The [Configuration] dialog box is displayed. Figure 3.3 [Configuration] Dialog Box * Set any value in the [AUD clock] and [JTAG clock] combo boxes. The clock also operates with the default value. Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. * Click the [OK] button to set a configuration. 30 3.6 Checking the Operation of the Target Memory for Downloading Check that the destination memory area for downloading is operating correctly. When the destination memory is SDRAM or DRAM, a register in the bus controller must be set before downloading. Set the bus controller correctly in the [I/O Registers] window according to the memory type. For details, refer to section 8.6, I/O Register Display, in the Hitachi Debugging Interface User's Manual. When the required settings, such as the settings for the bus controller, have been completed, display and edit the contents of the destination memory in the [Memory] window to check that the memory is operating correctly. Note: The above way of checking the operation of memory may be inadequate. It is recommended that a program for checking the memory be created. * Select [Memory...] from the [View] menu, enter H'0c000000 in the [Address] edit box, and set the format in the [Format] combo box to Byte. Figure 3.4 [Open Memory Window] Dialog Box * Click the [OK] button. The [Memory] window is displayed and shows the specified memory area. Figure 3.5 [Memory] Window 31 * Placing the mouse cursor on a point in the display of data in the [Memory] window and double clicking allows the values at that point to be changed. Data can also be directly edited around the current position of the text cursor. 32 3.7 3.7.1 Downloading the Tutorial Program Downloading the Tutorial Program Download the object program to be debugged. * Select [Load Program...] from the [File] menu. The [Load Program] dialog box is displayed. Enter `[installation directory]\tutorial\tutorial\Debug\tutorial.abs' in the [File name] list box as shown in figure 3.6, then click the [Open] button. Figure 3.6 [Load Program] Dialog Box Notes: 1. When installing the emulator, if no directory is specified and the HEW is in use, the program is installed under `\Hew\hdi5\e10a'. When the HEW is not in use, the program is installed under `\root directory\E10A'. 2. The SNI file is required so that the profiler function can be used. 3. The [Verify] check box is disabled in this product. After the file has been loaded, the following dialog box displays information about the memory areas to which the program code has been transferred. Figure 3.7 [HDI] Dialog Box * Click the [OK] button to continue. 33 3.7.2 Displaying the Source Program The HDI allows the user to debug a program at the source level. * Select [Source...] from the [View] menu. The [Open] dialog box is displayed. * Select the C source file that corresponds to the object file the user has loaded. Figure 3.8 [Open] Dialog Box * Select [tutorial.c] and click the [Open] button. The [Source] window is displayed. 34 Figure 3.9 [Source] Window (Displaying the Source Program) * If necessary, select the [Font] option from the [Customise] submenu on the [Setup] menu to select a font and size that are legible. Initially the [Source] window shows the start of the main program, but the user can use the scroll bar to scroll through the program and look at the other statements. 35 3.8 Setting a Software Breakpoint A breakpoint is a simple debugging function. The [Source] window provides a very simple way of setting a software breakpoint at any point in a program. For example, to set a breakpoint at the sort function call: * Select by double-clicking the [BP] column on the line containing the sort function call. Figure 3.10 [Source] Window (Setting a Software Breakpoint) The symbol * will appear on the line containing the sort function, and the word * Break will appear when the [BP] column is extended. This shows that a software breakpoint has been set. Note: The software breakpoint cannot be set in the ROM area. 36 3.9 Setting Registers Set values of the program counter and the stack pointer before executing the program. * Select [Registers] from the [View] menu. The [Registers] window is displayed. Figure 3.11 [Registers] Window 37 * To change the value of the program counter (PC), double-click the value area in the [Registers] window with the mouse. The following dialog box is then displayed, and the value can be changed. Set the program counter to H'0c00006c in this tutorial program, and click the [OK] button. * Move the mouse pointer on the value to be changed in the [PC] value area and enter the new value by the keyboard. Figure 3.12 [Register] Dialog Box (PC) * Change the value of the stack pointer (SP) in the same way. Set H'0c000c00 for the value of the stack pointer in this tutorial program. 38 3.10 Executing the Program Execute the program as described in the following: * To execute the program, select [Go] from the [Run] menu, or click the [Go] button on the toolbar. Figure 3.13 [Go] Button The program will be executed up to the breakpoint that has been inserted, and a statement will be highlighted in the [Source] window to show the position that the program has halted, with the message [Break=BREAKPOINT] in the status bar. Figure 3.14 [Source] Window (Break Status) 39 The user can see the cause of the break that occurred last time in the [System Status] window. * Select [Status] from the [View] menu. After the [System Status] window is displayed, open the [Platform] page, and check the status of Cause of last break. Figure 3.15 [System Status] Window Note: The items that can be displayed in this window differ according to the product. For the items that can be displayed, refer to the online help. 40 3.11 Reviewing Breakpoints The user can see all the breakpoints set in the program in the [Breakpoints] window. * Select [Breakpoints] from the [View] menu. Figure 3.16 [Breakpoints] Window The pop-up menu, opened by clicking the [Breakpoints] window with the right mouse button, also allows the user to set or change breakpoints, define new breakpoints, and delete, enable, or disable breakpoints. 41 3.12 Viewing Memory When the label name is specified, the user can view the memory contents that the label has been registered in the [Memory] window. For example, to view the memory contents corresponding to the _main in word size: * Select [Memory ...] from the [View] menu, enter _main in the [Address] edit box, and set Word in the [Format] combo box. Figure 3.17 [Open Memory Window] Dialog Box * Click the [OK] button. The [Memory] window showing the specified area of memory is displayed. Figure 3.18 [Memory] Window 42 3.13 Watching Variables As the user steps through a program, it is possible to watch that the values of variables used in the user program are changed. For example, set a watch on the long-type array a declared at the beginning of the program, by using the following procedure: * Click the left of displayed array a in the [Source] window to position the cursor. * Click the [Source] window with the right mouse button and select [Instant Watch...] from a pop-up menu. The following dialog box will be displayed. Figure 3.19 [Instant Watch] Dialog Box 43 * Click [Add Watch] button to add a variable to the [Watch] window. Figure 3.20 [Watch] Window (Displaying the Array) The user can also add a variable to the [Watch] window by specifying its name. * Click the [Watch] window with the right mouse button and select [Add Watch...] from the pop-up menu. The following dialog box will be displayed. Figure 3.21 [Add Watch] Dialog Box * Input variable max and click the [OK] button. 44 The [Watch] window will now also show the int-type variable max. Figure 3.22 [Watch] Window (Displaying the Variable) The user can double-click the + symbol to the left of any variable in the [Watch] window to watch the all elements in array a. Figure 3.23 [Watch] Window (Displaying Array Elements) 45 3.14 Stepping Through a Program The HDI provides a range of step menu commands that allow efficient program debugging. Table 3.2 Step Option Menu Command Step In Step Over Step Out Step... Description Executes each statement, including statements within functions. Executes a function call in a single step. Steps out of a function, and stops at the statement following the statement in the program that called the function. Steps the specified times repeatedly at a specified rate. 3.14.1 Executing [Step In] Command The [Step In] steps into the called function and stops at the first statement of the called function. * To step through the sort function, select [Step In] from the [Run] menu, or click the [Step In] button in the toolbar. Figure 3.24 [Step In] Button 46 Figure 3.25 [Source] Window (Step In) * The highlighted line moves to the first statement of the sort function in the [Source] window. 47 3.14.2 Executing [Step Out] Command The [Step Out] steps out of the called function and stops at the next statement of the calling statement in the main function. * To step out of the sort function, select [Step Out] from the [Run] menu, or click the [Step Out] button in the toolbar. Note: It takes time to execute this function. Figure 3.26 [Step Out] Button Figure 3.27 [HDI] Window (Step Out) * The data of variable a displayed in the [Watch] window is sorted in ascending order. 48 * To execute two steps, use [Step In] twice. Figure 3.28 [HDI] Window (Step In -> Step In) * The value of max displayed in the [Watch] window is changed to the maximum data value. 49 3.14.3 Executing [Step Over] Command The [Step Over] executes a function call as a single step and stops at the next statement of the main program. * Using [Step Over], execute two steps to reach the change function statement. Figure 3.29 [Source] Window (Before Step Over Execution) * To step through all statements in the change function at a single step, select [Step Over] from the [Run] menu, or click the [Step Over] button in the toolbar. Figure 3.30 [Step Over] Button 50 Figure 3.31 [HDI] Window (Step Over) 51 3.15 Forced Breaking of Program Executions The HDI can force a break in the execution of a program. * To execute the remaining sections of the main function, select [Go] from the [Run] menu or the [Go] button on the toolbar. Figure 3.32 [Go] Button * The program goes into an endless loop. To force a break in execution, select [Halt] from the [Run] menu or the [Stop] button on the toolbar. Figure 3.33 [Stop] Button * The highlighted line of the [Program] window moves to the while statement, and the value of max displayed in the [Watch] window is updated to the most recent value. 52 3.16 Displaying Local Variables The user can display local variables in a function using the [Locals] window. For example, we will examine the local variables in the main function, which declares five local variables: a, j, i, min, and max. * Select [Locals] from the [View] menu. The [Locals] window is displayed. Initially, the [Locals] window is empty because local variables have not yet been declared. The [Locals] window will now show the local variables and their values. Figure 3.34 [Locals] Window * Double-click the + symbol in front of array a in the [Locals] window to display the elements of array a. * Refer to the elements of array a before and after the execution of the sort function, and confirm that random data is sorted in descending order. 53 3.17 Break Function The emulator has software and hardware break functions. With the HDI, a software breakpoint can be set using the [Breakpoints] window, and a hardware break condition can be set using the [Break Condition] dialog box. An overview and setting of the break function are described below. 3.17.1 Software Break Function The emulator can set up to 255 software breakpoints. Other methods for setting a software breakpoint than in section 3.8 are described below. * Select [Breakpoints] from the [View] menu. The [Breakpoints] window is displayed. * Click the [Breakpoints] window with the right mouse button and select [Delete All] from the pop-up menu to cancel all the breakpoints that have been set. Figure 3.35 [Breakpoints] Window (Before Software Breakpoint Setting) 54 * Click the [Breakpoints] window with the right mouse button and select [Add] from the pop-up menu. The [Break] dialog box is displayed. The [Point] page is displayed as a default. Figure 3.36 [Point] Page ([Break] Dialog Box) 55 * Click the [Add...] button to display the [Breakpoint] dialog box. * Enter H'0c0000c2 to the [Value] edit box. Figure 3.37 [Break Point] Dialog Box * Click the [OK] button. 56 The [Break] dialog box is displayed. The address set in the value field of [Breakpoint] and the memory space are displayed. Figure 3.38 [Point] Page ([Break] Dialog Box) (After Software Breakpoint Setting) * Click the [Close] button (or [OK] button in some emulator products). 57 The software breakpoint that has been set is displayed in the [Breakpoints] window. Figure 3.39 [Breakpoints] Window (Software Breakpoint Setting) To stop the tutorial program at the breakpoint, the following procedure must be executed: * Close the [Breakpoints] window. * Set the program counter and stack pointer values (PC = H'0c00006c and R15 = H'0c000c00) that have been set in section 3.9, Setting Registers, in the [Registers] window. Click the [Go] button. The program runs, and stops at the set breakpoint. Figure 3.40 [Source] Window at Execution Stop (Software Break) 58 The [System Status] window displays the following contents. Figure 3.41 Displayed Contents of the [System Status] Window (Software Break) Note: The items that can be displayed in this window differ according to the product. For the items that can be displayed, refer to the online help. 59 3.18 Hardware Break Function A method is given below in which the address bus condition and the read cycles for the bus status condition are set under Break Condition 1 as hardware break conditions. * Select [Breakpoint Window] from the [View] menu. The [Breakpoints] window is displayed. * Click the [Breakpoints] window with the right mouse button and select [Delete All] from the pop-up menu to cancel all breakpoints that have been set. * Click the [Breakpoints] window with the right mouse button and select [Add] from the pop-up menu. Figure 3.42 [Breakpoints] Window (Before Hardware Break Condition Setting) 60 The [Break] dialog box is displayed. To set hardware break conditions, select [Condition] in the [Break] dialog box to display the [Condition] page. Figure 3.43 [Condition] Page ([Break] Dialog Box) Up to three breakpoints can be set independently for the Break Condition hardware break condition. In this example, set the hardware break condition for Break Condition 1. Note: The number of hardware break conditions differs according to the product. For the number that can be specified for each product, refer to the online help. * Highlight the first point in the [Break Condition] list box. * Click the [Edit...] button. The [Break Condition 1] dialog box is displayed. 61 * Clear the [Don't Care] check box in the [Address] page. * Select the [Address] radio button and enter H'0c0000b2 as the value in the [Address] edit box. Figure 3.44 [Address] Page ([Break Condition 1] Dialog Box) Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 62 * Select [Bus State] to display the [Bus State] page. * Select the [Read] radio button in the [Read/Write] group box. Figure 3.45 [Bus State] Page ([Break Condition 1] Dialog Box) Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 63 * Click the [OK] button. * The [Break] dialog box is displayed, and the first point display in the [Break Condition] list box changes from Empty to Enable. Figure 3.46 [Break] Dialog Box (After Hardware Break Condition Setting) Note: The number of hardware break conditions differs according to the product. For the number that can be specified for each product, refer to the online help. * Click the [OK] button. 64 The newly set hardware breakpoint is displayed in the [Breakpoints] window. With this setting, Break Condition 1 is displayed in [Type] in the [Breakpoints] window. This completes the setting of the Break Condition 1 hardware break condition. When the program is executed, a break will occur when address H'0c0000b2 is accessed in a read cycle. Figure 3.47 [Breakpoints] Window ([Break Condition 1] Setting) * Close the [Breakpoints] window. * Set the program counter and stack pointer values (PC = H'0c00006c and R15 = H'0c000c00) that have been set in section 3.9, Setting Registers, in the [Registers] window. Click the [Go] button. 65 The program runs then stops at the condition specified under Break Condition 1. Figure 3.48 [Source] Window at Execution Stop (Break Condition 1) 66 The [System Status] window displays the following contents. Figure 3.49 Displayed Contents of the [System Status] Window (Break Condition 1) Note: The items that can be displayed in this window differ according to the product. For the items that can be displayed, refer to the online help. 67 3.18.1 Setting the Sequential Break Condition The emulator has sequential break functions. When the hardware break conditions listed in table 3.3 are satisfied, program execution is halted. This mode is called sequential break. Table 3.3 Sequential Break Conditions Break Condition Sequential break condition 2-1 Description Program is halted when Break Condition 2 and Break Condition 1 are satisfied in that order. Sequential break condition 2-1 is described below as an example. Before executing the program, change setting in the [Configuration] dialog box. Otherwise, the sequential break does not function. * Select [Configure Platform...] from the [Setup] menu. The [Configuration] dialog box is displayed. * Select Sequential break condition 2-1 from the [Emulation mode] combo box. 68 Figure 3.50 [Configuration] Dialog Box (Sequential Break Setting) Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. Click the [OK] button and close the [Configuration] dialog box. 69 Set hardware break conditions as follows: Break condition 1: When address H'0c0000c6 is accessed in a read cycle, a break condition is satisfied. Break condition 2: When address H'0c0000b2 is accessed in a read cycle, a break condition is satisfied. Follow the setting method described in the previous section. * When Break Condition 1,2 setting has been completed, the state of the [Breakpoints] window is as follows. Figure 3.51 [Breakpoints] Window (After Sequential Break Condition Setting) * Close the [Breakpoints] window. * Set the program counter and stack pointer values (PC = H'0c00006c and R15 = H'0c000c00) that have been set in section 3.9, Setting Registers, in the [Registers] window. Click the [Go] button. 70 The program runs then stops at the condition specified under Break Condition 1. Figure 3.52 [Source] Window at Execution Stop (Sequential Break) 71 The [System Status] window displays the following contents. Figure 3.53 Displayed Contents of the [System Status] Window (Sequential Break) Note: The items that can be displayed in this window differ according to the product. For the items that can be displayed, refer to the online help. 72 3.19 Trace Functions The E10A emulator has two branch-instruction trace functions. (1) Internal Trace Function The branch source and branch destination addresses, mnemonics, operands, and source lines are displayed. Since this function uses the trace buffer built into the MCU, a realtime trace can be acquired. Notes: 1. The number of branch instructions that can be acquired by a trace differs according to the product. For the number that can be specified for each product, refer to the online help. 2. The internal trace function is not supported for all products. For the specifications of each product, refer to the section related to the trace functions in section 6, SHxxxx E10A Emulator Specifications, or to the online help. The internal trace function is not extended for all products. For the specifications of each product, refer to the section related to the trace functions in section 6, SHxxxx E10A Emulator Specifications, or to the online help. 3. (2) AUD Trace Function This is the large-capacity trace function that is enabled when the AUD pin is connected to the emulator. This function displays the branch source and branch destination addresses, mnemonics, operands, and source lines. When the branch source and branch destination instructions are one branch, the number of branch instructions acquired by a trace is a maximum of 4,096 in the PCMCIA-type emulator and a maximum of 16,384 in the PCI-type emulator. Table 3.4 shows the AUD trace function. Notes: 1. The AUD trace function is not supported for all products. For the specifications of each product, refer to the section related to the trace functions in section 6, SHxxxx E10A Emulator Specifications, or to the online help. 2. The AUD trace function is not extended for all products. For the specifications of each product or the number of acquired branches, refer to the section related to the trace functions in section 6, SHxxxx E10A Emulator Specifications, or to the online help. 73 Table 3.4 AUD Trace Functions Type Acquisition mode when branches continuously occur Mode Realtime trace Description When the next branch occurs while the trace information is being output, the output is stopped and the next trace information is output. The user program can be executed in realtime, but some trace information will not be output. When the next branch occurs while the trace information is being output, the CPU stops operations until the information is output. The user program is not executed in realtime. This function always overwrites the oldest trace information to acquire the latest trace information. The trace information is not acquired. The user program is continuously executed. Non realtime trace Acquisition mode when the trace buffer of the emulator becomes full Trace continue Trace stop 74 3.19.1 Internal Trace Function The branch source and branch destination information for the latest several branch instructions are displayed. The following is a procedure to set the internal trace function (this function is not needed to be set in the emulator that does not support the AUD trace function): 1. 2. 3. Select [Trace] from the [View] menu. Click the [Trace] window with the right mouse button and select [Acquisition] from the pop-up menu to display the [Trace Acquisition] window. Select the [Internal trace] radio button in the [Trace type] group box. Figure 3.54 [Trace mode] Window Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 75 Run the program as shown in the example of section 3.17.1, Software Break Function. The trace results are displayed in the [Trace] window after the program execution is completed. Figure 3.55 [Trace] Window * If necessary, adjust the column width by dragging the header bar immediately below the title bar. Note: The number of branch instructions that can be acquired by a trace differs according to the product. For the number that can be specified for each product, refer to the online help. 76 3.19.2 AUD Trace Function This function is operational when the AUD pin of the MCU is connected to the emulator. The following is the procedure for setting the AUD trace function (this function does not need to be set in an emulator that does not support the internal trace function): 1. 2. 3. Select [Trace] from the [View] menu. Click the [Trace] window with the right mouse button and select [Acquisition] from the pop-up menu to display the [Trace Acquisition] window. Select the [AUD trace] radio button in the [Trace type] group box. Figure 3.56 [Trace mode] Window Note: For a description of each option, refer to table 3.4. Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. The trace results are displayed in the [Trace] window after the program execution is completed. The display specifications in the [Trace] window are the same as the internal trace function. 77 The following is an example of the display in the SH7751 E10A emulator. Figure 3.57 [Trace] Window in the SH7751 E10A Emulator 78 3.19.3 VP_MAP Translation The MCU, which has an MMU, translates internal addresses (virtual addresses) to actual memory addresses (physical addresses). Address translation is performed according to the address translation table (translation look-aside buffer: TLB) in the MCU. The MMU operates during command input wait state as well as during user program execution. When a command for memory access is executed while the MMU address translation function is enabled, the address translated by the MMU is accessed. If the specified address is not within the TLB, a TLB miss occurs, and the TLB must be updated by the user program. The emulator has address translation functions according to the VP_MAP tables. The VP_MAP tables are the address translation tables for the emulator created with the VPMAP_SET command. The following shows an example of how to use the VP_MAP tables. Example: 1. Create VP_MAP tables for translating virtual addresses H'10000 to H'10FFF to physical addresses H'4000000 to H'4000FFF and virtual addresses H'11000 to H'11FFF to physical addresses H'0 to H'FFF. >vs 10000 10FFF 4000000 (RET) >vs 11000 11FFF 0 (RET) >vd (RET) 2. Then, enable the VP_MAP tables. (When the tables are disabled, addresses are not translated.) >ve ;enable (RET) >vd (RET) Here, virtual addresses correspond to physical addresses as shown in figure 3.58. 79 H'0 H'10000 H'10FFF H'11000 H'11FFF H'12000 H'12FFF H'FFF H'12000 H'12FFF H'4000000 H'4000FFF Virtual address Physical address Figure 3.58 Address Translation according to VP_MAP Tables How to translate addresses depends on the settings of the radio buttons of the memory area group in the [Configuration] dialog box. The following shows how to translate addresses in each setting state. * When the Normal radio button is selected: The VP_MAP table has a priority over the TLB. When the VP_MAP table is enabled and the specified address is within the VP_MAP table settings, the emulator translates the address according to the VP_MAP table. If the specified address is outside the VP_MAP table settings even when the VP_MAP table is enabled, or when the VP_MAP table is disabled, the emulator translates the address according to the MMU state. * When the Virtual radio button is selected: The address is translated according to the TLB. If the specified address is outside the TLB table settings, a TLB error will occur. * When the Physical radio button is selected: The address is not translated. 80 Table 3.5 Address Translation Tables VP_MAP Radio Button* Normal Enabled/ Disabled Enabled Within/ Outside the range Within the Range MMU Enabled/ Disabled Enabled Within/Outside the TLB Range Within the Range Outside the range Disabled Outside the Range Enabled Within/outside the range Within the Range Outside the range Disabled Disabled Within/ outside the range Enabled Within/outside the range Within the Range Table Used for Translation Translated according to the VP_MAP table Translated according to the VP_MAP table Translated according to the VP_MAP table Translated according to the TLB table TLB error Not translated Translated according to the TLB table TLB error Not translated Translated according to the TLB table TLB error Translated according to the TLB table TLB error Not translated Outside the range Disabled Virtual Enabled/ disabled Within/ outside the range Enabled Within/outside the range Within the Range Outside the range Disabled Within the Range Outside the range Physical Enabled/ disabled Within/ outside the range Enabled/ disabled Within/outside the range Note: Specified by the [Memory area] group box in the [Configuration] dialog box. 81 3.20 Stack Trace Function The emulator uses the stack's information to display the name of the calling function for a function at which the program counter is currently pointing. Notes: 1. This function can be used only when the load module that has the Dwarf2-type debugging information is loaded. 2. For details on the stack trace function, refer to the online help. * Double-click the [BP] column in the sort function and set a software breakpoint. Figure 3.59 [Source] Window (Software Breakpoint Setting) * Set the same program counter and stack pointer values (PC = H'0c00006c and R15 = H'0c000c00) as were set in section 3.9, Setting Registers (again, use the [Registers] window). Click the [Go] button. * After the break in execution, select [Stack Trace] from the [View] menu to open the [Stack Trace] window. 82 Figure 3.60 [Stack Trace] Window Figure 3.60 shows that the position of the program counter is currently at the selected line of the sort() function, and that the sort() function is called from the main() function. Notes: 1. If the function is not deeply nested (lower than 10), the main() function will be displayed multiple times. 2. For details on this function, refer to the online help. The online help is opened when the [F1] key is pressed in the [Stack Trace] window. 83 3.21 Profiling Function The profile function can measure performance for each function. Notes: 1. Realtime operation is not possible while this function is in operation, since internal breaks are generated during program execution. Measuring the profile itself affects the measurements. For details, refer to section 6, SHxxxx Emulator Specifications. 2. 3. When this function is to be used, click the [Load stack information file (SNI file)] check box in the [Load Program] dialog box to load the stack information file. Performance profile measurement is not supported for all products. On those products for which it is supported, its characteristics differ according to the product. For specifications for each product, refer to the section related to the trace functions in section 6, SHxxxx E10A Emulator Specifications, or to the online help file. For details, refer to section 13 in the Hitachi Debugging Interface User's Manual. 4. * Select [Profile-List] from the [View] menu to open the [Profile-List] window. A different set of data to be measured can be set for each function. Figure 3.61 [Profile-List] Window 84 * The profile function is now enabled. Place the mouse cursor on an entry in the [Profile-List] window, click the right-hand mouse button, then select [Enable Profiler] from the pop-up menu. Figure 3.62 Selection of [Enable Profiler] 85 * Data to be measured for the selected function is now set. Select [Select Data] from the pop-up menu by clicking with the right mouse button. The [Select Data] dialog box is displayed. Figure 3.63 [Select Data] Dialog Box * Use the [Select Data] dialog box to select the data to be measured. [All operand access count] is selected for Data1 as a first item to be measured. [Elapsed-time cycle] is selected for Data2 as a second item to be measured. * After the data has been selected, press the [OK] button. * Double-click the [BP] column for the while statement of the main function to set a software breakpoint. 86 Figure 3.64 [Source] Window (Software Break Setting) * Set the same program counter and stack pointer values (PC = H'0c00006c and R15 = H'0c000c00) as were set in section 3.9, Setting Registers (again, use the [Registers] window). Click the [Go] button. * After the break in execution, the results of the measurements are displayed in the [Profile-List] window. Figure 3.65 [Profile-List] Window 87 * Figures 3.66 and 3.67 show the [Profile-Tree] and [Profile-Chart] windows, respectively. Figure 3.66 [Profile-Tree] Window Figure 3.67 [Profile-Chart] Window 88 3.22 Download Function to the Flash Memory Area The E10A emulator enables downloading to the flash memory area. This function requires a program for writing the flash memory (hereinafter referred to as a write module), a program for erasing the flash memory (hereinafter referred to as an erase module), and the RAM area for downloading and executing these modules. Note: The write/erase module must be prepared by users. Interface with write/erase module and E10A emulator firmware The write/erase module is branched from the E10A emulator firmware. To branch from the E10A emulator firmware to the write/erase module or to return from the write/erase module to the E10A emulator firmware, the following conditions must be observed: * Describe all the write/erase modules with the assembly language. * Guarantee all the general/control register values before and after calling the write/erase module. * Return the write/erase module to the calling source after processing. The module interface must be as follows to pass correctly the information that is required for flash memory accessing. Table 3.6 Module Interface Module Name Write module Argument R4(L): Write address R7(L): Verify option 0 = no verify, 1 = verify R5(L): Access size 0x4220 = byte, 0x5720 = word, 0x4C20 = longword R6(L): Write data Erase module R4(L): Access size 0x4220 = byte, 0x5720 = word, 0x4C20 = longword None Return Value R0(L): End code Normal end = 0, Abnormal end = other than 0, Verify error = BT Note: The (L) means the longword size. Note: Write module: The write data for the access size is set to the R6 register. When the access size is word or byte, 0 is set to the upper bit of the R6 register. 89 Flash memory download method It is required to perform necessary settings on the [Loading flash memory] page in the [Configuration] window for downloading to the flash memory. Figure 3.68 [Loading flash memory] Page 90 Table 3.7 shows the options for the [Loading flash memory] page. Table 3.7 [Loading flash memory] Page Options Option [Loading flash memory] radio button Description Sets Enable for flash memory downloading. At Enable, when [File load] is selected from the [File] menu for downloading, the write module is always called. Enable: Download to the flash memory Disable: Not download to the flash memory Sets Enable for erasing before the flash memory is written. At Enable, the erase module is called before calling the write module. Enable: Erase the flash memory Disable: Not erase the flash memory Sets the write/erase module name. The file that has been set is loaded to the RAM area before loading to the flash memory. A maximum of 128 characters can be input for the file name. Sets the bus width of the flash memory. Sets the TIMEOUT value at flash memory erasing. Increase the value if erasing requires much time; the default time is three minutes. The radix for the input value is decimal. It becomes hexadecimal by adding H'. Sets the calling destination address of the write/erase module. [All erasing module address] edit box: Inputs the calling destination address of the erase module. [Writing module address] edit box: Inputs the calling destination address of the write module. Note: Although the values that can be set are D'0 to D'65535, the TIMEOUT hours may be extended according to the set value. Therefore, it is recommended to input the minimum value. The value to be input must only be positive integer. [Erasing flash memory] radio button [File name] edit box [Bus width of flash memory] list box [Flash memory erasing time] edit box* [Entry point] group box Notes on using the flash memory download function The following are notes on downloading to the flash memory. * When the flash memory download is enabled, downloading other than to the flash memory area is disabled. * Downloading is only enabled to the flash memory area. Perform memory write or software break only to the RAM area. * When the flash memory erase is enabled, the [Stop] button cannot stop erasing. * The area for the write/erase module must be MMU-disabled space. * Only the S-type-formatted file is enabled for the write/erase module. 91 Examples of downloading to the flash memory The following shows examples of downloading to the flash memory manufactured by Intel Corporation (type number: G28F640J5-150) that has been mounted on Hitachi's SH7751 CPU board (type number: HS7751STC01H). A sample is provided in the \Fmtool folder in the installation destination folder. Create the program for user specification according to this sample. The SH7751 E10A emulator must be used when the SH7751 CPU board is used. Table 3.8 Example of Board Specifications Item SDRAM address Flash memory address Bus width of flash memory Operating environments CPU internal frequency Bus frequency CPU internal module frequency Endian Contents H'0C000000 to H'0FFFFFFF H'01000000 to H'01FFFFFF 32 bits 167 MHz 55.7 MHz 27.83 MHz Big endian Flash memory (32 Mbytes) SHxxxx A0-A22 CE0 CE1,2 OE WE D0-D7 D8-D15 8-15 0-7 FIA bus buffer FPGA GND FIA bus buffer A2-A24 CS0 CS2 RD WE0 FD bus buffer D0-D31 D0-D7 D8-D15 D0-D7 D8-D15 D0-D7 D8-D15 24-31 16-23 Figure 3.69 Flash Memory Wiring 92 Table 3.9 Sample Program Specifications Item RAM area to be used Write module start address Erase module start address Contents H'0C001000 to H'0C0015BF H'0C001100 H'0C001000 (i) Since the SDRAM is used, the bus controller is set. (ii) Options on the [Loading flash memory] page in the [Configuration] window are set as follows: Figure 3.70 [Loading flash memory] Page 93 Notes: 1. When the data has already been written in the flash memory, be sure to select [Enable] for [Erasing flash memory]. If [Disable] is selected, a verify error occurs. 2. When [Erasing flash memory] is selected, it takes about one minute. (iii) [Load Program...] is selected from the [File] menu for downloading to the flash memory area. 94 3.23 What Next? This tutorial has described the major features of the emulator and the use of the HDI. Sophisticated debugging can be carried out by using the emulation functions that the emulator offers. This provides for effective investigation of hardware and software problems by accurately isolating and identifying the conditions under which such problems arise. Further details on the use of the HDI can be found in the separately issued Hitachi Debugging Interface User's Manual. 95 96 Section 4 Descriptions of Windows 4.1 HDI Windows HDI window menu bars and the corresponding pull-down menus are listed in table 4.1. Where a description of a menu is included in the Hitachi Debugging Interface User's Manual or in this manual, a O mark or the relevant section number is shown. Related commands in the E10A Emulator User's Manual are also shown. Table 4.1 HDI Window Menus and Related Manual Entries Hitachi Debugging Interface User's Manual Menu Bar File menu Pull-Down Menu New Session... Load Session... Save Session Save Session As... Load Program... Initialize Exit This Manual -- -- 2.6 -- 3.7.1 -- -- -- -- -- -- -- Edit Menu Cut Copy Paste Find... Evaluate... O O O O O O O O O O O O 97 Table 4.1 HDI Window Menus and Related Manual Entries (cont) Hitachi Debugging Interface User's Manual Menu Bar View Menu Pull-Down Menu Breakpoints Command Line Disassembly... I/O Area Labels Locals Memory... Performance Analysis Profile-List Profile-tree Registers Source... Stack Trace Status Trace Watch This Manual 3.11, 3.17.1, 4.2.4, 6.5.5 -- -- -- -- 3.16 3.12 -- 3.21 3.21 3.9 3.7.2 3.20 3.10, 3.17.1, 4.2.9 4.2.7, 6.5.3, 6.5.7 3.13 -- 3.10 -- -- -- -- 3.14.1 3.14.3 3.14.2 -- -- Run Menu Reset CPU Go Reset Go Go to Cursor Set PC To Cursor Run... Step In Step Over Step Out Step... Halt O O O O O O O O O O O O X O O O O O O O O O O O O O O 98 Table 4.1 HDI Window Menus and Related Manual Entries (cont) Hitachi Debugging Interface User's Manual Menu Bar Pull-Down Menu This Manual -- -- -- -- -- -- -- -- -- -- -- -- 3.5, 4.2 -- -- -- -- -- -- -- -- Memory Menu Refresh Load Save Verify Test Fill Copy Compare Setup Menu Status bar Options Radix Customise Configure Platform... Window Menu Cascade Tile Arrange Icons Close All Help Menu Index Using Help Search for Help on About HDI O O O O O O O O O O O O O O O O O O O O O 99 4.2 Descriptions of Each Window This section describes each window. Figures in this section are used as examples. Each E10A emulator type has explanatory notes. Read section 6, SHxxxx E10A Emulator Specifications. 4.2.1 [Configuration] Dialog Box Function: This dialog box sets the emulation conditions of the emulator. Window: Figure 4.1 [Configuration] Dialog Box Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 100 Description: The [Configuration] dialog box consists of the [General] page listed in table 4.2. Table 4.2 [Configuration] Dialog Box Page Page Name [General] [Loading flash memory] Description Sets and displays the emulation mode conditions. Sets the download function for the flash memory. Clicking the [OK] button sets the emulation conditions. If the [Cancel] button is clicked, this dialog box is closed without setting the emulation conditions. 101 (1) [General] Page ([Configuration] Dialog Box) Function: This page sets the emulator operation conditions, displays the device name, sets the emulation mode, UBC mode, and memory area (only for a product that supports a device with the MMU function), sets and displays the AUD clock (AUDCK) and JTAG clock (TCK), and selects the driver. Window: Figure 4.2 [General] Page ([Configuration] Dialog Box) Note: The items and displayed contents that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 102 Description: Table 4.3 [General] Page Options Option [Mode] combo box [Emulation mode] combo box Description Displays the device name. Selects the execution mode. Select Normal to perform normal emulation. Select No Break to disable breakpoint settings. Select Sequential break Condition 2-1, etc. to use the sequential *1 break function . (For Sequential break Condition 2-1, execution stops when conditions are satisfied in the order of Break Condition 2 and Break Condition 1.) Enables or disables interrupts during step execution. Disables interrupts during single step execution: Interrupts during step execution are masked. Enables interrupts during single step execution: Interrupts during step execution are released. [UBC mode] combo box EML: The UBC is used as a Break Condition by the emulator. USER: The UBC is released for users. In this case, the [Break Condition] page becomes non-active. [Memory area] group box Sets the address setting mode to the memory area. The default is Normal. When the VP_MAP is enabled and the address is within the table range, address translation is done according to the VP_MAP table. For other cases, address translation is done according to the MMU state. Select Physical when setting with a physical address. Select Virtual when address translation is done by the TLB table. [AUD clock] combo box [JTAG clock] combo box [Driver] group box [Change...] button Selects the AUD clock . Sets the JTAG frequency . Displays the driver currently selected. Displays the [E10A Driver Details] dialog box. Use when a driver currently connected is changed. *3 *2 [Step option] combo box Notes: 1. When using the sequential break function, set the corresponding hardware break conditions. 2. The range of frequencies that the AUD operates under is different according to the devices used. For details, refer to section 6.5.4, Notes on Using the JTAG Clock (TCK) and AUD Clock (AUDCK). 3. The range of frequencies that the JTAG operates at is different according to the devices used. For details, refer to section 6.5.4, Notes on Using the JTAG Clock (TCK) and AUD Clock (AUDCK). 103 When a driver is to be changed with the [Change..] button, the following message is displayed. Figure 4.3 Warning Message Box When the [Yes] button is clicked, the [E10A Driver Details] dialog box is displayed. When the [No] button is clicked, the display returns to the [Configuration] dialog box. Related Command: GO_OPTION command 104 (2) [E10A Driver Details] Dialog Box Function Function: When the [Change] button in the [Driver] group box is clicked on the [General] page in the [Configuration] dialog box, the [E10A Driver Details] dialog box is displayed. Figure 4.4 [E10A Driver Details] Dialog Box Description: Table 4.4 Options for the [E10A Driver Details] Dialog Box Option [Driver] combo box Description Selects the driver to connect the HDI with the emulator. Selects [E10A PC Card Driver] to use the PCMCIA card emulator. Selects [E10A PCI Card Driver] to use the PCI card emulator. For details, refer to section 6.5.1, Emulator Driver Selection. Displays the interface name of the card emulator to be connected. Selects [PC Card] to use the PCMCIA card emulator. Selects [PCI] to use the PCI card emulator. (If the driver is not installed, the [PC Card] or [PCI] is not displayed.) Displays the interface to which the board is connected. [Interface] combo box [Channel] combo box 105 (3) [Loading flash memory] Page ([Configuration] Dialog Box) Function: Downloading to the flash memory is set on the [Loading flash memory] page. Window: Figure 4.5 [Loading flash memory] Page ([Configuration] Dialog Box) 106 Description: Table 4.5 [Loading flash memory] Page Options Option [Loading flash memory] radio button Description Sets Enable for flash memory downloading. At Enable, when [File load] is selected from the [File] menu for downloading, the write module is always called. Enable: Download to the flash memory Disable: Not download to the flash memory Sets Enable for erasing before the flash memory is written. At Enable, the erase module is called before calling the write module. Enable: Erase the flash memory Disable: Not erase the flash memory Sets the write/erase module name. The file that has been set is loaded to the RAM area before loading to the flash memory. A maximum of 128 characters can be input for the file name. Sets the bus width of the flash memory. Sets the TIMEOUT value at flash memory erasing. Increase the value if erasing requires much time; the default time is three minutes. The radix for the input value is decimal. It becomes hexadecimal by adding H'. Sets the calling destination address of the write/erase module. [All erasing module address] edit box: Inputs the calling destination address of the erase module. [Writing module address] edit box: Inputs the calling destination address of the write module. Note: Although the values that can be set are D'0 to D'65535, the TIMEOUT hours may be extended according to the set value. Therefore, it is recommended to input the minimum value. The value to be input must only be positive integer. [Erasing flash memory] radio button [File name] edit box [Bus width of flash memory] list box [Flash memory erasing time] edit box* [Entry point] group box Notes on using the flash memory download function The following are notes on downloading to the flash memory. * When the flash memory download is enabled, downloading other than to the flash memory area is disabled. * Downloading is only enabled to the flash memory area. Perform memory write or software break only to the RAM area. * When the flash memory erase is enabled, the [Stop] button cannot stop erasing. * The entry area for the user module must be MMU-disabled space. 107 4.2.2 [Breakpoints] Window Function: This window lists all break conditions that have been set. Window: Figure 4.6 [Breakpoints] Window 108 Description: The [Breakpoints] window displays breakpoint setting information. The items listed in the following tables are displayed. Table 4.6 [Breakpoints] Window Display Items Item [Enable] Description Displays whether the break condition is enabled or disabled. BREAKPOINT: l Break Condition: m (If the address is the same as the one that has been set to the BREAKPOINT, the mark is l.) [File/Line] [Symbol] [Address] [Type] Displays the file name and line number where the breakpoint is set. Displays the symbol corresponding to the breakpoint address. If no symbol has been defined for the address, nothing is displayed. Displays the address where the breakpoint is set. Displays the break condition type as follows: Break Point: Software breakpoint (Virtual or physical address is determined according to the MMU state at setting.) Break Point Virtual Space ASID = D'xxx: Software breakpoint (Virtual address. ASID value is displayed in decimal.) Break Point Physical Space: Software breakpoint (Physical address.) Break Condition 1 to Break Condition 3: Hardware break condition Note: Only "Break Point" is displayed in the [Type] item when the device does not support the MMU. 109 The pop-up menu, which is opened by clicking the right mouse button, can be used to set, change, and clear breakpoints, and to enable or disable break conditions. The pop-up menu functions are described in the following table. Table 4.7 [Breakpoints] Window Pop-up Menu Operation Menu Name [Add] [Edit] Description Sets break conditions. Clicking this button will display the [Break] dialog box, enabling break conditions to be set. Changes break conditions. Select break conditions to be changed and click this button. The break condition setting dialog box will be displayed, enabling the break condition to be changed. Enables or disables break conditions. Select break conditions to be enabled or disabled and click this button. Clears break conditions. Select break conditions to be cleared and click this button. Clears all break conditions. Jumps to the address which sets the break in the [Source] window. [Disable] ([Enable]) [Delete] [Del All] [Go to Source] 110 4.2.3 [Break] Dialog Box Function: This dialog box displays the break condition settings. Window: Figure 4.7 [Break] Dialog Box 111 Description: The [Break] dialog box consists of the pages listed in table 4.8. Table 4.8 [Break] Dialog Box Pages Page Name [Point] [Condition] Description Displays software breakpoint settings. Displays Break Condition settings. The dialog boxes which set or modify break conditions can be displayed from the pages above. Clicking the [OK] button (or [Close] button in some emulator products) will close this dialog box. 112 (1) [Point] Page ([Break] Dialog Box) Function: This page displays software breakpoint settings. In this page, software breakpoints can be set, changed, and cleared. Window: Figure 4.8 [Point] Page ([Break] Dialog Box) 113 Description: Table 4.9 [Point] Page Options Option [Break point] list box Description Lists the software breakpoints currently being set. The display contents are Sets software breakpoints. Clicking this button displays the [Break Point] dialog box. Changes the software breakpoint selected in the [Break point] list box. Clicking this button displays the [Break Point] dialog box. Clears the software breakpoint selected in the [Break Point] list box. Clears all software breakpoints displayed in the [Break Point] list box. Related Commands: BREAKPOINT command BREAKPOINT_CLEAR command BREAKPOINT_ENABLE command BREAKPOINT_DISPLAY command 114 (2) [Condition] Page ([Break] Dialog Box) Function: This page displays the Break Condition settings. These conditions can also be set or cleared in this page. Window: Figure 4.9 [Condition] Page ([Break] Dialog Box) Note: The number of hardware break conditions differs according to the product. For the number that can be specified for each product, refer to the online help. 115 Description: Table 4.10 [Condition] Page Options Option [Break Condition] list box Description Displays the Break Condition settings. The display at system initiation is as follows: When conditions are set, Enable is displayed. When no conditions are set, Empty is displayed. 1 Empty (setting of Break Condition 1) 2 Empty (setting of Break Condition 2) : [Edit...] button [Reset] button [Reset All] button Changes the Break Condition settings selected in the [Break Condition] list box. Clicking this button displays the [Break Condition] dialog boxes. Clears the Break Condition settings selected in the [Break Condition] list box. Clears all Break Condition settings in the [Break Condition] list box. Related Commands: BREAKCONDITION_CLEAR command BREAKCONDITION_DISPLAY command BREAKCONDITION_ENABLE command BREAKCONDITION_SET command 116 4.2.4 [Break Point] Dialog Box Function: This dialog box sets software breakpoints. Window: Figure 4.10 [Break Point] Dialog Box Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 117 Description: The [Break Point] dialog box consists only of the [Address] page. This dialog box sets address conditions and address areas. The [Address] page options are as follows: Table 4.11 [Address] Page Options Option [Value] edit box [Normal] radio button [Physical Space] radio button [Virtual Space] radio button [ASID] edit box Description Sets a breakpoint address with a number or a symbol. Does not set an address area.* Shows that the break condition is the physical area.* Shows that the break condition is the virtual area.* Sets an ASID value (0 to 255) when the breakpoint address is in the virtual area. Nothing is set as default.* Note: These options are not supported in a device in which the MMU is not built-in. Clicking the [OK] button enables breakpoints to be set. If the [Cancel] button is clicked, this dialog box is closed without setting breakpoints. Related Commands: BREAKPOINT command BREAKPOINT_CLEAR command BREAKPOINT_DISPLAY command BREAKPOINT_SET command 118 4.2.5 [Break Condition] Dialog Box Function: This dialog box sets hardware break conditions. Window: Figure 4.11 [Break Condition] Dialog Box Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 119 Description: The [Break Condition] dialog box consists of multiple pages. A condition to halt the program can be set in each page. Contents to be set by each page are described in section 4.2.6, [Break Condition] Dialog Box Pages. Clicking the [OK] button sets the hardware break conditions. If the [Cancel] button is clicked, the dialog box is closed without setting the hardware break conditions. Related Commands: BREAKCONDITION_CLEAR command BREAKCONDITION_DISPLAY command BREAKCONDITION_ENABLE command BREAKCONDITION_SET command 120 4.2.6 [Break Condition] Dialog Box Pages Function: The [Break Condition] dialog box pages allow a number of hardware break conditions to be set. Some functions may not be supported by some types of emulators. The setting conditions may differ from the dialog box name in table 4.12. For details, refer to section 6.5.2, Break Condition Functions. Table 4.12 Setting Conditions in [Break Condition] Dialog Boxes Type LDTLB Instruction Break and Internal I/O Access Break Conditions X X Dialog Box [Break Condition 1] dialog box [Break Condition 2] dialog box [Break Condition 3] dialog box Bus State and Address Bus Data Bus Read/Write Condition Condition Conditions Count Condition O O X O X X O O X O X X O Note: O: Can be set by checking the radio button in the dialog box. X: Cannot be set in the dialog box. 121 Table 4.13 shows all the [Break Condition] dialog box pages. Table 4.13 [Break Condition] Dialog Box Pages Page Name [Address] Function Sets the address conditions of Break Condition 1 and Break Condition 2. (Address condition is not displayed in the [Break Condition 3] dialog box page.) Sets the data conditions of Break Condition 1. (Data condition is not displayed in the [Break Condition 2] and [Break Condition 3] dialog box pages.) Sets the ASID conditions of Break Condition 1 and Break Condition 2. (ASID condition is not displayed in the [Break Condition 3] dialog box page.) Sets the bus state conditions and read/write cycle conditions of Break Condition 1 and Break Condition 2. (Bus state condition is not displayed in the [Break Condition 3] dialog box page.) Sets the satisfaction count conditions of Break Condition 1. (Count condition is not displayed in the [Break Condition 2] and [Break Condition 3] dialog box pages.) Sets the conditions of Break Condition 3. (Data condition is not displayed in the [Break Condition 1] and [Break Condition 2] dialog box pages.) [Data] [ASID] [Bus State] [Count] [General] Note: This function differs according to the product. For the specifications of each product, refer to section 6.5.2, Break Condition Functions, or to the online help. 122 (1) [Address] Page ([Break Condition] Dialog Box) Function: This page sets the address bus conditions. Window: Figure 4.12 [Address] Page ([Break Condition 1] Dialog Box) Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 123 Description: Table 4.14 [Address] Page Options Option [Don't Care] check box [Address] radio button [Only program fetched address] radio button [Only program fetched address after] radio button [X-bus address] radio button [Y-bus address] radio button [Address] edit box [Non user mask] radio button [User mask] radio button [Mask] edit box Description Does not set address conditions. Sets use of the normal address bus as break conditions. Sets a break before prefetched address execution as break conditions. Sets a break after prefetched address execution as break conditions. Sets the X-bus address as a break condition. Can be set only with Break Condition 1. Sets the Y-bus address as a break condition. Can be set only with Break Condition 1. Sets the address bus value with a number or a symbol. Sets no mask conditions. Sets mask conditions. Sets the mask bits if [User mask] is selected. For masked bits, the break condition is satisfied regardless of the address values. Note: This page is displayed when the conditions of Break Condition 1 and Break Condition 2 are set. A page name to be displayed and the contents of an option that can be set will change depending on the radio button selected. Table 4.15 Address Options Option [Address] radio button, [X-Bus address] radio button, and [Y-Bus address] radio button [Only program fetched address] radio button Description All pages can be selected and masks can be set. The [Address] and [ASID] pages can be set; however, no mask can be set. [Only program fetched address after] radio The [Address] and [ASID] pages can be set. button Note: This function differs according to the product. For the specifications of each product, refer to section 6.5.2, Break Condition Functions, or to the online help. 124 (2) [Data] Page ([Break Condition] Dialog Box) Function: This page sets the data bus conditions. Window: Figure 4.13 [Data] Page ([Break Condition 1] Dialog Box) Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 125 Description: Table 4.16 [Data] Page Options Option [Don't Care] check box [Value] edit box [Byte] radio button [Word] radio button [Long] radio button [X-bus data] radio button [Y-bus data] radio button [Non user mask] radio button [User mask] radio button [Mask] edit box Description Does not set data conditions. Sets the data bus value with a number. Sets byte data access cycles. Sets word data access cycles. Sets longword data access cycles. Sets X-bus data access cycles. Sets Y-bus data access cycles. Does not set mask conditions. Sets mask conditions. Sets the mask bits when [User mask] is selected. Mark a bit to be masked with *. For masked bits, the break conditions will be satisfied regardless of the data values. Note: This page is displayed when the conditions of Break Condition 1 are set. 126 (3) [ASID] Page ([Break Condition] Dialog Box) Function: This page sets the ASID conditions. Window: Figure 4.14 [ASID] Page ([Break Condition] Dialog Box) Description: Table 4.17 [ASID] Page Options Option [Don't Care] check box [ASID] edit box Description Does not set ASID conditions. Sets the ASID condition value. The default is 0. Note: This page is displayed when the conditions of Break Condition 1 and Break Condition 2 are set. Note: These options are not supported in a device in which the MMU is not built-in. 127 (4) [Bus State] Page ([Break Condition] Dialog Box) Function: This page sets bus state conditions and read/write cycle conditions. Window: Figure 4.15 [Bus State] Page ([Break Condition] Dialog Box) Note: The items that can be set in this window differ according to the product. For the settings for each product, refer to the online help. 128 Description: Table 4.18 [Bus State] Page Options Group Box [Bus State] group box Option [All] radio button [Data] radio button [DMA] radio button [Read/Write] group box [Read/Write] radio button Description Sets the bus state conditions as break conditions. Sets the execution cycle as break conditions. Sets DMA cycles as a break condition. Sets the read/write cycle conditions as break conditions. [Read] radio button Sets read cycles as break conditions. [Write] radio button Sets write cycles as break conditions. Note: This page is displayed when the conditions of Break Condition 1 and Break Condition 2 are set. 129 (5) [Count] Page ([Break Condition] Dialog Box) Function: This page sets the conditions for Break Condition 1. Window: Figure 4.16 [Count] Page ([Break Condition] Dialog Box) Table 4.19 [Count] Page Options Option [Don't Care] check box Input area Description Sets no satisfaction count conditions. Sets the satisfaction count as a break condition. The maximum count is 4,095. Breaks when the conditions set by the [Break Condition] dialog box for the specified times are satisfied. The default is D'1. Note: Some products are not supported by this function. For the specifications of each product, refer to the online help. 130 (6) [General] Page ([Break Condition] Dialog Box) Function: This page sets the conditions for Break Condition 3. Window: Figure 4.17 [General] Page ([Break Condition] Dialog Box) 131 Description: Table 4.20 [General] Page Options Group Box [LDTLB] group box Option [Don't Care] radio button [Stop after executing LDTLB instruction] radio button [DMA] radio button [I/O] group box [Don't Care] radio button Description Does not set break conditions when the LDTLB instruction is executed. Sets the LDTLB instruction execution as break conditions. Sets the DMA cycle as break conditions. Does not set break conditions when the internal I/O area is accessed. [Stop on accessing Sets the internal I/O area access as break conditions. internal I/O area] radio button [Write] radio button Sets only write cycle as break conditions. Note: Some products are not supported by this function. For the specifications of each product, refer to the online help. 132 4.2.7 [Trace] Window Function: This window displays the trace buffer contents. Window: Figure 4.18 [Trace] Window Note: The types of information and the number of branch instructions differ according to the product. For the settings for each product, refer to the online help. 133 Description: This window displays the trace buffer contents. The items listed in table 4.21 are displayed. Table 4.21 [Trace] Window Display Items Item [No.] [IP] [TYPE] Description Displays the number in ascending order as the trace stop point is 0 (signed decimal). Displays the instruction pointer (signed decimal). For the branch instruction trace, displays the information type, that is, branch source or branch destination. BRANCH: Branch source DESTINATION: Branch destination For the branch instruction trace, displays the branch source or branch destination address. Displays the execution instruction mnemonic. Displays the execution instruction operand. Displays the C-source line of the address that the trace has been acquired. [ADDR/DATA] [MNEMONIC] [OPERAND] [Source] The pop-up menu, opened by clicking the right mouse button, can be used to set, change, and clear trace conditions. For details, refer to the Hitachi Debugging Interface User's Manual. Notes: 1. In some cases, the emulator address may be acquired by trace. In such a case, the following message will be displayed. Ignore this address because it is not a user program address. *** EML *** 2. The [Halt] menu in the pop-up menu is active only when the [Trace] window is open during user program execution. When the internal trace is used, realtime emulation cannot be performed by using the [Halt] menu. Related Command: TRACE_DISPLAY command 134 4.2.8 [Trace Acquisition] Dialog Box Function: This dialog box sets trace acquisition conditions. When the [Acquisition] menu is selected from the pop-up menu, which is displayed by clicking the right mouse button in the [Trace] window, the [Trace Acquisition] dialog box is displayed. Table 4.22 [Trace Acquisition] Dialog Box Page Options Page Name [Trace Mode] Description Sets the conditions of trace mode. 135 (1) [Trace Mode] Page ([Trace Acquisition] Dialog Box) Function: This page sets the conditions for trace mode. Window: Figure 4.19 [Trace mode] Page ([Trace Acquisition] Dialog Box) Note: This function differs according to the product. For the specifications of each product, refer to the section related to the trace functions in section 6, SHxxxx E10A Emulator Specifications, or to the online help. 136 Description: Table 4.23 [Trace mode] Page Options Option [AUD trace] radio button [Internal trace] radio button [Realtime trace] radio button Description Uses AUD trace functions. By default, this box is not checked. Uses the internal trace functions. By default, this box is checked. When the next branch occurs while the trace information is being output, the information is stopped and the next trace information is output. The user program can be executed in realtime, but some trace information will not be output. By default, this box is checked. [Non realtime trace] radio button When the next branch occurs while the trace information is being output, the CPU stops operations until the information is output. The user program is not executed in realtime. By default, this box is not checked. [Trace continue] radio button When the trace buffer becomes full, this function always overwrites the oldest trace information to acquire the latest trace information. When the trace buffer becomes full, the trace information is not acquired. [Trace stop] radio button [AUD trace display range] group Inputs the start or end pointer value in the trace display range as box numerical values. By default, the start pointer is -D'8191 and the end pointer is -D'0000. In the PCMCIA card emulator, -D'8191 to D'0 can be set to the trace pointer. In the PCI card emulator, -D'32767 to D'0 can be set. Related Command: AUD_MODE command 137 4.2.9 [System Status] Window Function: This window lists information, such as conditions that have been set to the emulator and execution results. Window: Figure 4.20 [System Status] Window Note: The items that can be displayed in this window differ according to the product. For the items that can be displayed, refer to the online help. 138 The items listed in the following table are displayed in the [System Status] window. Table 4.24 [System Status] Window Display Items Page [Session] Item Target System Session Name Program Name [Platform] Connected To CPU Run status Description Always displays Connected. Displays the session file name. Displays the load module file name. Displays the name of the connected emulator and the selected driver name. Displays the target device name. Displays the execution status: RUNNING: Being executed Break: Stopped Displays the cause of the emulator stopping at break. In this example, the cause of the stop is BREAK POINT. Displays the program execution time. The display format is h: hours, min: minutes, s: seconds, and ms: milliseconds. In this example, 0h:0min:0s:16ms is displayed. Displays the emulator operating mode (setting information for [Emulation Mode] of the [Configuration] dialog box). Displays the endian state (Big Endian or Little Endian). In this example, Big Endian is displayed. Displays whether the AUD function can be used. This item is displayed by the emulator with the AUD function. Displays the loaded area of the load module. Displays the usage states of BREAKPOINT and Break Condition. Cause of last break Run time count Emulator mode Big Endian/Little Endian AUD [Memory] [Events] Loaded Memory Areas Resources 139 140 Section 5 Command-line Functions 5.1 Table and Symbol Description This section describes the format used in section 5.2, Command Descriptions. The descriptions of some commands are given over two or more pages. 5.1.1 Format The input format for each command is as follows. Characters shown in bold-italics are to be input. [] : Parameters enclosed by [ ] can be omitted. < > : Contents shown in < > are set. < >=: The parameter to the left of the "=" sign is input in the format shown to the right. | || : This represents a non-exclusive selection. : This represents an exclusive selection. The command parameter details are described in the parameter table. 5.1.2 Parameter Input Numerical Parameters: A binary, octal, decimal, or hexadecimal value, a symbol, or a formula can be input. A symbol can contain up to 32 characters. Terms in a formula are separated with operators (such as + or -). Keyword Parameters: One of the bold characters given in the description column of the table can be input. If a character string not shown in the description is input, an error will occur. Character-String Parameters: Character-string parameters are used to input mask data or a file name. In the mask data, set a radix (H': hexadecimal or B': binary) at the top of a character string and set * at the digit to be masked. 141 5.1.3 Examples These are actual input examples. For commands whose execution results in a specific display output, an example of the display is given. 5.1.4 Related Items Related E10A HDI commands (abbreviations) and dialog boxes are shown. (Refer to section 4, Descriptions of Windows.) 142 5.2 Command Descriptions The command list of the E10A emulator is shown below. Table 5.1 E10A HDI Commands No. Command 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 AUD_CLOCK AUD_MODE AUD_TRACE BREAKCONDITION_ CLEAR BREAKCONDITION_ DISPLAY BREAKCONDITION_ ENABLE BREAKCONDITION_ SET BREAKPOINT BREAKPOINT_CLEAR BREAKPOINT_DISPLAY BREAKPOINT_ENABLE DEVICE_TYPE GO_OPTION JTAG_CLOCK MEMORYAREA_SET Abb. Function AUCL Sets the AUD clock (AUDCK). AUM AUT BCC BCD BCE BCS BP BC BD BE DE GP JCK MAS Sets AUD trace conditions. Displays trace information. Clears hardware breakpoints that have been set. Displays hardware breakpoints that have been set. Enables or disables hardware breakpoints that have been set. Sets hardware breakpoints. Sets software breakpoints. Clears software breakpoints that have been set. Displays software breakpoints that have been set. Enables or disables software breakpoints that have been set. Displays device type currently selected. Displays or sets the emulation mode during user program execution. Displays or sets a JTAG clock (TCK) frequency. Displays or sets memory area at command input, such as load, verify, save, memory display, or memory change. 143 Table 5.1 E10A HDI Commands (cont) No. Command 16 17 18 19 20 21 22 23 24 25 REFRESH RESTART STATUS STEP_INTERRUPT TRACE_DISPLAY UBC_MODE VPMAP_CLEAR VPMAP_DISPLAY VPMAP_ENABLE VPMAP_SET Abb. Function RF RST STS SI TD UM VC VD VE VS Updates the HDI memory information to the latest contents. Restarts the emulator. Displays emulator state information. Displays or sets the enable or disable status of interrupts during step execution. Displays acquired trace buffer information. Displays or sets UBC use states. Clears the emulator address translation (VP_MAP) table which has been set. Displays the emulator address translation (VP_MAP) table. Enables or disables the emulator address translation (VP_MAP) table. Sets emulator address translation (VP_MAP) table. Note: Support for these commands varies with the product. For the specifications of each product, refer to the online help. 144 5.2.1 AUD_CLOCK:AUCL Description: Sets or displays the AUD clock (AUDCK) values that have been set. Format: aucl [ |
Price & Availability of SH7290E10A
 |
|
|
|
|
All Rights Reserved © IC-ON-LINE 2003 - 2022 |
| [Add Bookmark] [Contact Us] [Link exchange] [Privacy policy] |
|
Mirror Sites : [www.datasheet.hk]
[www.maxim4u.com] [www.ic-on-line.cn]
[www.ic-on-line.com] [www.ic-on-line.net]
[www.alldatasheet.com.cn]
[www.gdcy.com]
[www.gdcy.net] |